Мы рады объявить о выпуске 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.

Ресурсы