Мы рады объявить о выпуске GroupDocs.Conversion for .NET v26.10, доступном с октября 2026. Этот выпуск посвящён контролю над тем, какие ресурсы документ может загружать: ваш код теперь может решать, какие внешние ресурсы запрашивает документ, а значения по умолчанию безопасны для документов из неизвестных источников. Он также заставляет конвертации учитывать запрошенный формат вывода и выбор страниц, исправляет ряд сбоев конвертации и проблем загрузки в .NET Framework, а также обновляет чувствительную к безопасности зависимость — всего 60 функций, улучшений и исправлений ошибок.

Основные моменты

Решайте, что каждый документ может загружать

Документы часто ссылаются на внешние ресурсы: изображения на CDN, таблицы стилей, скрипты, 3D‑текстуры, таксономии XBRL. В версии 26.10 вы можете видеть каждый такой запрос и решать о нём в коде. Реализуйте IExternalResourceHandler и задайте его через свойство ExternalResourceHandler параметров загрузки. Обработчик получает каждый ресурс с уже установленным решением по умолчанию и может разрешить его, пропустить или — для большинства форматов — предоставить содержимое самостоятельно, например из собственного кэша, так что запросов не будет.

Этот обработчик загружает JPEG‑изображения с одного доверенного хоста поверх того, что разрешают значения по умолчанию:

public class TrustedJpegHandler : IExternalResourceHandler
{
    public void OnLoading(ExternalResourceLoadingArgs args)
    {
        Uri uri;
        if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
            && uri.Scheme == Uri.UriSchemeHttps
            && string.Equals(uri.Host, "cdn.example.com", StringComparison.OrdinalIgnoreCase)
            && (uri.AbsolutePath.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
                || uri.AbsolutePath.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase)))
        {
            args.Skipped = false;
        }
    }
}
WebLoadOptions loadOptions = new WebLoadOptions
{
    ExternalResourceHandler = new TrustedJpegHandler()
};
using (Converter converter = new Converter("sample.html", (LoadContext loadContext) => loadOptions))
{
    converter.Convert("converted.pdf", new PdfConvertOptions());
}

Обработчик работает с параметрами загрузки для веб‑документов, XML, текстовых процессоров, электронных таблиц, CSV и TSV, презентаций, электронной почты, SVG, финансовых и 3D‑документов.

Безопасные значения по умолчанию для недоверенных документов

Конвертация загруженного пользователем файла не должна заставлять ваш сервер читать другие файлы или обращаться к произвольным хостам. При настройках по умолчанию в версии 26.10:

  • загружает локальные файлы только из папки самого документа и никогда не использует UNC‑пути;
  • не выполняет скрипты в документах HTML, MHTML, XHTML и SVG и не запрашивает файлы скриптов;
  • применяет те же правила к конвертациям SVG, 3D‑моделей, XBRL, XSL‑FO, Markdown и из электронной почты в электронные таблицы.

Если вашим документам действительно нужны внешние ресурсы, разрешайте их подходящим способом: перечислите доверенные места в WhitelistedResources, решайте по каждому ресурсу с помощью обработчика или установите SkipExternalResources = false для доверенных документов. Скрипты выполняются только при установке ExecuteScripts = true в WebLoadOptions или SvgLoadOptions. UNC‑пути и ссылки javascript: или vbscript: никогда не загружаются, независимо от настроек.

Вывод, который вы запросили

Некоторые конвертации игнорировали часть запроса. Некоторые всегда записывали DOCX, XLSX, PPTX или многостраничный TIFF независимо от выбранного целевого формата, а выбор страниц игнорировался при конвертации из электронной почты, веб‑документов и многостраничного TIFF в текстовый процессор, для документов Word Flat OPC и при конвертации Project в PS и PCL. Теперь все они выводят то, что указано в параметрах конвертации. Водяные знаки теперь также появляются при конвертации не графических документов в изображения и при конвертации CSV и TSV; страницы MHT и MHTML рендерятся вместо отображения их MIME‑источника, а прозрачные фоны больше не становятся чёрными в выводе J2K, JP2, WMF и WMZ.

Меньше неудачных конвертаций

Файлы PostScript, использующие оператор run или file в .NET Framework, документы PSD, PSB и AI постранично, полные чертежи CAD в TeX, XHTML с встроенным SVG, PDF, XPS и SVG в EPUB, а также Visio и SVG в электронные таблицы теперь конвертируются вместо того, чтобы завершаться ошибкой. В файлах электронной почты, почтовых ящиков и архивов вложение, которое нельзя конвертировать в целевой формат, больше не приводит к провалу всей конвертации, а вложенный документ, который не удалось загрузить, теперь сообщается через ConversionEvents.OnDocumentFailed.

Безопасность, лицензирование и .NET Framework

  • System.Security.Cryptography.Pkcs переходит на версию 8.0.2 (10.0.13 в .NET 10), устраняя CVE-2026-84008 и CVE-2026-70162.
  • .NET Framework проекты больше не падают при загрузке RuntimeInformation или ValueTuple, а конвертации EML, HTML и CAD больше не завершаются ошибкой в .NET Framework 4.6.2‑4.7.0.
  • Конвертации WebP с действующей лицензией больше не отображают значок пробной версии. В режиме оценки ограничение в 3 страницы теперь также применяется к выводам SVG, SVGZ, PS и PCL.

Что нового в этом выпуске

  • [Feature] Добавить обратный вызов для каждого ресурса, позволяющий проверять, разрешать, отклонять или предоставлять каждый внешний ресурс, загружаемый документом
  • [Improvement] Предоставить SvgLoadOptions в качестве параметров загрузки для документов SVG и SVGZ
  • [Improvement] Наименовывать элементы OLM и NSF без темы по папке и позиции и избегать зарезервированных имён устройств Windows в названиях элементов почтового ящика
  • [Improvement] Сообщать о архивах, письмах и элементах почтового ящика, которые нельзя загрузить, обработчику document-failed вместо простого логирования
  • [Bug] Значок пробной версии применяется при конвертации из WebP, даже если действующая лицензия применена
  • [Bug] Конвертация конкретного файла VSDX — текст выходит за пределы рамки
  • [Bug] Двойное зачёркивание текста не сохраняется при конвертации ODT в PDF
  • [Bug] Проблемы конвертации VCF в Excel
  • [Bug] Исправить конвертации, не загружающие RuntimeInformation в проектах старого стиля .NET Framework 4.7.1+ с использованием PackageReference
  • [Bug] Исправить конвертации, не загружающие RuntimeInformation или ValueTuple в проектах .NET Framework с packages.config
  • [Bug] Исправить конвертации EML, HTML и CAD, падающие в средах .NET Framework 4.6.2‑4.7.0
  • [Bug] При конвертации документов WordProcessing, Pdf и ProjectManagement в любой формат электронных таблиц всегда получался XLSX
  • [Bug] При конвертации документов WordProcessing, Pdf и Diagram в любой формат презентаций всегда получался PPTX
  • [Bug] Исправить конвертацию PST, OST и MBOX, падающую на элементе без темы, а также конвертацию стикеров PST в нечитаемый текст
  • [Bug] При конвертации одностраничного документа в формат изображения, отличный от TIFF, всегда получался многостраничный TIFF
  • [Bug] [GroupDocs.Conversion for .NET] Обновить System.Security.Cryptography.Pkcs до 8.0.2 (CVE-2026-84008 / CVE-2026-70162)
  • [Bug] Текстовый или графический водяной знак не применяется при конвертации не графических документов в изображения
  • [Bug] Прозрачный фон страницы становится чёрным при конвертации в J2K, JP2, WMF и WMZ
  • [Bug] Вывод WMZ из документов Word содержит сжатый gzip PNG, а вывод EMZ из изображений сжат дважды
  • [Bug] Страницы MHT и MHTML, конвертированные в изображения, показывают MIME‑источник вместо страницы
  • [Bug] Информация о документе Publisher всегда сообщает одну страницу
  • [Bug] Водяной знак не применяется при конвертации документов CSV и TSV
  • [Bug] Загружать внешние ресурсы только из точных префиксов URL из whitelist и из папки самого документа, никогда не из UNC‑путей
  • [Bug] Исправить сохранение CAD, Image, Diagram, DjVu, VCF и Email в WordProcessing как DOCX для всех целей, кроме DOC
  • [Bug] Исправить игнорирование выбора страниц и диапазона страниц при конвертации Email в WordProcessing
  • [Bug] Исправить игнорирование выбора страниц при конвертации многостраничного TIFF в WordProcessing
  • [Bug] Учитывать SkipExternalResources и WhitelistedResources при конвертации документов Markdown и CHM
  • [Bug] Учитывать SkipExternalResources и WhitelistedResources при конвертации email‑to‑spreadsheet, spreadsheet и диапазонов страниц
  • [Bug] По умолчанию не загружать изображения из вне папки документа при конвертации HTML в электронную таблицу
  • [Bug] По умолчанию не загружать внешние ресурсы при конвертации SVG в презентацию, word processing, spreadsheet, XPS или EPS
  • [Bug] По умолчанию не загружать 3D‑библиотеки материалов, текстуры и буферы из вне папки модели
  • [Bug] По умолчанию не загружать внешние изображения при конвертации XML через таблицу стилей XSL-FO
  • [Bug] Исправить сохранение HTML и MHTML в WordProcessing как DOCX для всех целей
  • [Bug] По умолчанию не загружать XBRL и встроенные XBRL‑таксономии из вне папки документа
  • [Bug] Прекратить выполнение скриптов и загрузку файлов скриптов при конвертации документов HTML, XHTML и SVG
  • [Bug] Исправить игнорирование выбора страниц и диапазона страниц при конвертации Web в WordProcessing
  • [Bug] Исправить игнорирование выбора страниц и диапазона страниц в документах Word Flat OPC
  • [Bug] По умолчанию не встраивать текстуры из вне папки модели при конвертации 3D‑документов
  • [Bug] Исправить конвертацию архивов с однопоточным сжатием, у которых файл не имеет имени
  • [Bug] Исправить загрузку ссылок javascript: и vbscript:, когда внешние ресурсы разрешены
  • [Bug] Исправить сбой конвертации XHTML‑документов со встроенным SVG
  • [Bug] Исправить сбой конвертации HTML в HTML, когда относительный CSS @import не может быть загружен
  • [Bug] Исправить сбой конвертации Visio и SVG в электронную таблицу на странице без содержимого для рисования
  • [Bug] Исправить сбой конвертации PDF, XPS и SVG в EPUB при гиперссылке, не охватывающей текст
  • [Bug] Исправить сбой конвертации email, mailbox и archive при вложении, которое нельзя конвертировать в целевой формат
  • [Bug] Исправить замену шрифтов Courier New и других установленных шрифтов при конвертации PCL после конвертации PDF
  • [Bug] GroupDocs.Conversion.LowCode 26.9.0: DOCX в PDF на Linux игнорирует замену шрифтов и использует первый в алфавитном порядке шрифт
  • [Bug] Исправить ошибки XML‑документации в GroupDocs.Conversion.LowCode 26.9.0
  • [Bug] Исправить сбой конвертации PostScript в .NET Framework, когда документ использует оператор run или file
  • [Bug] Исправить не лицензированные конвертации в форматы языков описания страниц, игнорирующие ограничение пробных страниц
  • [Bug] Исправить постраничную конвертацию документов PSD, PSB и Illustrator AI, завершающуюся исключением
  • [Bug] Исправить сбой конвертации видео в аудио формат, даже когда установлен видеосоединитель
  • [Bug] Исправить конвертацию ProjectManagement в PS и PCL, создающую лишние страницы и игнорирующую выбор страниц
  • [Bug] Исправить запись ProjectManagement в SVG в UTF-16 без маркера порядка байтов
  • [Bug] Исправить запись файлов буфера и материалов при конвертации 3D в glTF и OBJ в рабочий каталог
  • [Bug] Исправить отображение MIME‑источника вместо страницы при конвертации MHT и MHTML в PDF, XPS, TeX и WordProcessing
  • [Bug] Исправить сбой конвертации CAD в TeX полного чертежа с ошибкой FileTypeNotSupported
  • [Bug] Исправить добавление лишних страниц при конвертации PDL и XML/JSON в PS и PCL
  • [Bug] Исправить сохранение только одной страницы из многостраничных чертежей DWF при конвертации CAD в PS и PCL
  • [Bug] Исправить сбой или потерю заголовков письма при конвертации MBOX, когда тема сообщения выглядит как имя файла

Изменения публичного API

Новый API

  • IExternalResourceHandler и ExternalResourceLoadingArgs (Uri, Skipped, Data) в пространстве имён GroupDocs.Conversion.Options.Load.
  • ExternalResourceHandler в IResourceLoadingOptions и параметрах загрузки, которые его реализуют.
  • ExecuteScripts в WebLoadOptions и SvgLoadOptions.
  • SkipExternalResources, WhitelistedResources и ExternalResourceHandler в FinanceLoadOptions и ThreeDLoadOptions, которые теперь реализуют IResourceLoadingOptions.

⚠️ Проверьте перед обновлением

  • Внешние ресурсы: документы, которые полагались на локальные файлы вне своей папки, UNC‑пути или скрипты, теперь конвертируются без них. Разрешайте только то, чему доверяете, как описано в Safe defaults for untrusted documents.

  • Элементы whitelist: каждая запись WhitelistedResources должна быть абсолютным префиксом URI, например https://cdn.example.com/assets/ или file:///C:/assets/. Записи вроде jpg или example.com, которые в ранних версиях совпадали где‑угодно в URL, теперь вызывают ошибку загрузки с InvalidLoadOptionsException.

  • XBRL и встроенный XBRL: файл, таксономия которого находится вне его папки, или загруженный из потока, теперь не загружается и выдаёт InvalidLoadOptionsException. Загружайте надёжные файлы так:

    using (Converter converter = new Converter("filing.xbrl", (LoadContext loadContext) => new FinanceLoadOptions { SkipExternalResources = false }))
    {
        converter.Convert("filing.xlsx", new SpreadsheetConvertOptions());
    }
    
  • SVG и SVGZ: при конвертации без параметров загрузки теперь используется SvgLoadOptions, а PossibleConversions.LoadOptions возвращает SvgLoadOptions вместо PageDescriptionLanguageLoadOptions.

  • Формат вывода и страницы: конвертации теперь учитывают запрошенный формат и выбор страниц, поэтому вывод может отличаться от предыдущих версий при тех же параметрах. PublisherDocumentInfo.PagesCount теперь возвращает реальное количество страниц.

  • Пользовательские реализации IResourceLoadingOptions должны добавить новое свойство ExternalResourceHandler.

В release notes перечислены все изменения с точными сообщениями об исключениях.

Как получить обновление

NuGet

Обновите до последнего пакета GroupDocs.Conversion через NuGet: GroupDocs.Conversion 26.10.0

dotnet add package GroupDocs.Conversion --version 26.10.0

Прямое скачивание

Скачайте сборки со страницы GroupDocs.Conversion for .NET 26.10

Ресурсы