Мы рады объявить о выпуске 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
Ресурсы
- Full Release Notes
- Documentation
- Network access and data privacy – когда библиотека обращается к сети и как запускать её офлайн
- Skip loading of external resources – значения по умолчанию, записи whitelist, обработчик для каждого ресурса и скрипты
- Migration notes – миграция на 26.10
- Load options for different document types
- GitHub examples – доверенные места, обработчик для каждого ресурса, скрипты доверенного HTML и XBRL с удалённой таксономией
- Free Support Forum