Мы рады объявить о выпуске GroupDocs.Merger for .NET v26.10, доступном с октября 2026. Этот выпуск представляет крупные улучшения в управлении загрузкой внешних ресурсов, решает критические проблемы конкурентности при обработке EPUB и TeX, улучшает разбиение EPUB на страницы, сохраняет формат PDF и заголовок в автоматически размеченном выводе, а также исправляет несколько ошибок, связанных с .NET Framework. В целом, он включает 10 функций, улучшений и исправлений.
Что нового в этом выпуске
- [Feature] Пропускать загрузку внешних ресурсов по умолчанию, с белым списком доверенных мест и обработчиком для каждого ресурса
- [Bug] Исправить NullReferenceException для EPUB‑документов, у которых файл оглавления не имеет расширения .ncx
- [Bug] Исправить сбой объединения изображений при загрузке System.ValueTuple в проектах .NET Framework с packages.config
- [Bug] Исправить сбой объединения с SVG‑документами на рантаймах .NET Framework 4.6.2‑4.7.0
- [Bug] Отображать страницы фиксированного EPUB по одной на страницу книги вместо разделения каждой на две
- [Bug] Обновить System.Security.Cryptography.Pkcs до 8.0.2 и 9.0.21 (CVE-2026-84008, CVE-2026-70162)
- [Bug] Сохранять оригинальный формат PDF и заголовок при сохранении с включённым авторазмечиванием
- [Bug] Исправить ArgumentException при одновременной загрузке TeX‑документов
- [Bug] Сохранять вывод LowCode, указанный как простое имя файла, в текущий каталог и отклонять объединяемые документы другого формата
- [Bug] Исправить периодические сбои EPUB‑документов с NullReferenceException или IndexOutOfRangeException при одновременной обработке
Изменения публичного API
1. Внешние ресурсы — отклоняются по умолчанию (новый API, несовместимый с предыдущими версиями)
Новые публичные типы в пространстве имён GroupDocs.Merger.Domain.Options:
| Type | Описание |
|---|---|
| IResourceLoadingOptions | Определяет SkipExternalResources, WhitelistedResources и ExternalResourceHandler. LoadOptions реализует его. |
| IExternalResourceHandler | Её метод OnLoading вызывается для каждого внешнего ресурса перед его загрузкой и может разрешить, пропустить или заменить его. |
| ExternalResourceLoadingArgs | Ресурс, передаваемый в OnLoading: Uri, Skipped (предустановлен в соответствии с решением двух других опций) и Data (содержимое, которое использовать вместо загрузки ресурса). |
Новые свойства LoadOptions:
SkipExternalResources—trueпо умолчанию во всех конструкторах. Покаtrue, ни один внешний ресурс не загружается, кроме тех, что соответствуютWhitelistedResourcesили разрешены обработчиком.WhitelistedResources— абсолютные URI‑префиксы ресурсов, которые загружаются, покаSkipExternalResourcesравноtrue, напримерhttps://cdn.example.com/assets/илиfile:///C:/assets/. По умолчанию пусто.ExternalResourceHandler—nullпо умолчанию.
Несовместимые изменения:
- Внешние ресурсы больше не загружаются по умолчанию. Удалённые ресурсы (
http,https,ftpи другие схемы), UNC‑пути, локальные файлы, включая файлы в папке самого документа, и относительные ссылки, указывающие за пределы документа, пропускаются, и операция продолжается. Ранние версии их загружали. Поэтому удалённые изображения и таблицы стилей HTML, Word и презентаций могут отсутствовать в выводе, а количество страниц HTML и Word‑документов может измениться. Содержимое, которое документ несёт —data:URI,cid:ссылки, части MHTML и упакованные медиа — всё ещё загружается. Чтобы загрузить внешние ресурсы, добавьте их местоположения в белый список или установитеSkipExternalResourcesвfalseдля доверенных документов. LoadOptionsтеперьsealed. Класс, наследующий его, больше не компилируется. ИспользуйтеLoadOptionsнапрямую или реализуйтеILoadOptions; пользовательская реализацияILoadOptions, которая также не реализуетIResourceLoadingOptions, получает политику по умолчанию.- Элемент
WhitelistedResources, который является null, пустым, не является абсолютным URI, содержит запрос или фрагмент, либо содержит%2F,%5Cили%2E, заставляет конструкторMergerбросатьArgumentException(«Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.»). - Если обработчик бросает исключение, ресурс пропускается, и операция бросает
GroupDocsMergerException(«The external resource handler threw an exception; the resource was skipped. See the inner exception.») с исключением обработчика в качествеInnerException. - EPUB‑документы, а также SVG и SVGZ‑документы в некоторых операциях теперь проверяют разметку на внешние ссылки. Документ, разметка которого не является корректным XML, завершается с
GroupDocsMergerException(«The document’s markup could not be read to check it for external resources, so it was not loaded. Set SkipExternalResources to false without an ExternalResourceHandler to load it without the check.»). - Конструкторы
OleDiagramOptions,OleSpreadsheetOptionsиOleWordProcessingOptions, принимающие путь к файлу и номер страницы, рендерят изображение встроенного объекта с отклонёнными внешними ресурсами, независимо от того, что позволяютLoadOptionsцелевого документа. Чтобы отобразить их, передайте свои данные изображения в конструктор, который их принимает. - Продукты пакета
GroupDocs.Merger.LowCodeвсегда отклоняют внешние ресурсы.
Опции читаются при создании Merger, и документы, присоединяемые к нему, следуют этим опциям.
2. Автоматически размеченные PDF‑документы сохраняют формат и заголовок источника
Без изменений API. PDF‑документ, сохранённый с PdfSaveOptions.AccesibilitySettings.EnableAutoTagging, установленным в true, сохраняет формат PDF и заголовок источника. Раньше каждый автоматически размеченный документ помечался как PDF/UA-1, а беззаголовочный источник получал заголовок «Tagged PDF». Авторазметка добавляет логическое дерево структуры; она не делает документ соответствующим PDF/UA, и источник, уже помеченный как PDF/UA, сохраняет эту метку.
3. Фиксированного макета EPUB‑документы — одна страница на страницу книги
Без изменений API. EPUB‑документ фиксированного макета теперь имеет одну страницу на страницу книги. Раньше каждая страница книги рендерилась как две страницы, поэтому GetDocumentInfo сообщал вдвое большее количество страниц, и страница N не соответствовала странице книги N. Номера страниц, передаваемые в операции над страницами, такие как ExtractPages, RemovePages или Split, теперь относятся к страницам книги.
4. GroupDocs.Merger.LowCode — путь вывода и объединяемые документы
JoinPdf,JoinDocx,JoinPptxиRemovePagesPdfразрешают относительный путь вывода относительно текущего рабочего каталога. Путь вывода, указанный как простое имя файла, теперь сохраняется в текущий каталог; ранее он сохранялся в каталог вывода по умолчанию Merger. Null или пустой путь вывода бросаетArgumentNullException.JoinPdf,JoinDocxиJoinPptxбросаютFileTypeNotSupportedException, когда расширение объединяемого документа не соответствует формату продукта, до записи любого вывода, например «Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’». РаньшеJoinPdfиJoinDocxсоздавали смешанный вывод, аJoinPptxпозже выдавал другое сообщение. Null или пустой путь к объединяемому документу бросаетArgumentNullException(«The document at index 0 is null or empty.»).- Все семь продуктов бросают
FileTypeNotSupportedException(«Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.») для пути источника без расширения, вместоArgumentException.
5. Зависимости
- Пакеты времени выполнения зависят от System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80и их пакетов.Windows) или 9.0.21 (GroupDocs.Merger.Net100иGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowsиGroupDocs.Merger.LowCodeтакже зависят от System.Formats.Asn1 8.0.2, аGroupDocs.Merger.LowCode— от System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462не изменён. - В проектах .NET Framework пакет
GroupDocs.Mergerбольше не добавляет привязку (binding redirect) для System.ValueTuple вapp.configилиweb.config(проекты packages.config), и его сборки .NET Framework устанавливаютDependsOnNETStandardвtrue, если проект не задаёт другое значение.
Новые возможности
- Управление внешними ресурсами: Удалённые изображения, таблицы стилей, связанные картинки и другие файлы, на которые ссылается документ, больше не загружаются, если вы их не разрешаете.
LoadOptionsимеет новые свойстваSkipExternalResources,WhitelistedResourcesиExternalResourceHandlerдля разрешения доверенных мест, разрешения всего для доверенных документов или решения, пропуска или предоставления каждого ресурса в вашем коде. - Исправления конкурентности: EPUB‑документы больше не падают периодически с
NullReferenceExceptionилиIndexOutOfRangeException, а TeX‑документы — сArgumentException, когда они обрабатываются из нескольких потоков. - EPUB‑документы: EPUB‑документы фиксированного макета теперь имеют одну страницу на страницу книги, так что страница N соответствует странице книги N. EPUB‑документы, у которых файл оглавления имеет расширение, отличное от
.ncx, больше не вызываютNullReferenceException. - Вывод автоматически размеченного PDF: PDF‑документ, сохранённый с авторазметкой, сохраняет формат и заголовок источника. Он больше не помечается как PDF/UA-1, если только источник не был помечен, и беззаголовочный источник больше не получает заголовок «Tagged PDF».
- Проекты .NET Framework: Объединения изображений в проектах packages.config больше не вызывают ошибку загрузки System.ValueTuple, а объединения с SVG‑документами больше не вызывают ошибку загрузки netstandard на рантаймах .NET Framework 4.6.2‑4.7.0.
- Обновлённая зависимость: Пакеты зависят от System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 и .NET 8.0) или 9.0.21 (.NET 10.0), версии, исправляющие CVE-2026-84008 и CVE-2026-70162.
- Продукты LowCode: Путь вывода, указанный как простое имя файла, сохраняется в текущий каталог, а
JoinPdf,JoinDocxиJoinPptxотклоняют объединяемый документ другого формата до записи любого вывода.
Пример кода
using System.Collections.Generic;
using GroupDocs.Merger;
using GroupDocs.Merger.Domain;
using GroupDocs.Merger.Domain.Options;
var loadOptions = new LoadOptions(FileType.HTML)
{
// Load resources from one trusted folder only; everything else stays denied
WhitelistedResources = new List<string> { "https://cdn.example.com/assets/" }
};
using (var merger = new Merger("page1.html", loadOptions))
{
merger.Join("page2.html");
merger.Save("merged.html");
}
using System;
using GroupDocs.Merger.Domain.Options;
public class TrustedPngHandler : IExternalResourceHandler
{
public void OnLoading(ExternalResourceLoadingArgs args)
{
Uri uri;
if (Uri.TryCreate(args.Uri, UriKind.Absolute, out uri)
&& uri.Scheme == Uri.UriSchemeHttps
&& uri.Host == "cdn.example.com"
&& uri.AbsolutePath.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
{
args.Skipped = false; // allow; any other resource keeps the default decision
}
}
}
Как получить обновление
NuGet
Обновите до последней версии пакета GroupDocs.Merger через NuGet: GroupDocs.Merger 26.10.0
dotnet add package GroupDocs.Merger --version 26.10.0
Прямое скачивание
Скачайте сборки со страницы GroupDocs.Merger for .NET 26.10.