Z przyjemnością ogłaszamy wydanie GroupDocs.Merger for .NET v26.10, dostępne od października 2026. To wydanie wprowadza istotne ulepszenia w kontrolowaniu ładowania zasobów zewnętrznych, rozwiązuje krytyczne problemy współbieżności w przetwarzaniu dokumentów EPUB i TeX, poprawia paginację EPUB, zachowuje format PDF i tytuł w wyjściu z automatycznym tagowaniem oraz naprawia kilka błędów związanych z .NET Framework. Łącznie zawiera 10 funkcji, ulepszeń i poprawek błędów.

Co nowego w tym wydaniu

  • [Feature] Pomijanie ładowania zasobów zewnętrznych domyślnie, z listą zaufanych lokalizacji i obsługą per‑zasób
  • [Bug] Naprawiono NullReferenceException dla dokumentów EPUB, których plik spisu treści nie ma rozszerzenia .ncx
  • [Bug] Naprawiono łączenie obrazów, które nie ładowało System.ValueTuple w projektach .NET Framework z packages.config
  • [Bug] Naprawiono łączenie dokumentów SVG, które nie działało w środowiskach .NET Framework 4.6.2‑4.7.0
  • [Bug] Renderowanie stron EPUB o stałym układzie po jednej stronie na stronę książki zamiast dzielenia każdej na dwie
  • [Bug] Zaktualizowano System.Security.Cryptography.Pkcs do wersji 8.0.2 i 9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [Bug] Zachowano oryginalny format PDF i tytuł przy zapisywaniu z włączonym automatycznym tagowaniem
  • [Bug] Naprawiono ArgumentException podczas równoczesnego ładowania dokumentów TeX
  • [Bug] Zapisano wyjście LowCode podane jako samą nazwę pliku do bieżącego katalogu i odrzucono połączone dokumenty innego formatu
  • [Bug] Naprawiono przerywane błędy NullReferenceException lub IndexOutOfRangeException w dokumentach EPUB przy równoczesnym przetwarzaniu

Zmiany w publicznym API

1. Zasoby zewnętrzne — odrzucane domyślnie (nowe API, niekompatybilne wstecz)

Nowe publiczne typy w przestrzeni nazw GroupDocs.Merger.Domain.Options:

Typ Opis
IResourceLoadingOptions Definiuje SkipExternalResources, WhitelistedResources i ExternalResourceHandler. LoadOptions implementuje go.
IExternalResourceHandler Metoda OnLoading jest wywoływana dla każdego zasobu zewnętrznego przed jego załadowaniem i może go zezwolić, pominąć lub zastąpić.
ExternalResourceLoadingArgs Zasób przekazywany do OnLoading: Uri, Skipped (wstępnie ustawiony zgodnie z decyzją pozostałych dwóch opcji) oraz Data (zawartość do użycia zamiast ładowania zasobu).

Nowe właściwości LoadOptions:

  • SkipExternalResources — domyślnie true w każdym konstruktorze. Gdy jest true, żaden zasób zewnętrzny nie jest ładowany, z wyjątkiem tych pasujących do WhitelistedResources lub dozwolonych przez obsługę.
  • WhitelistedResources — absolutne prefiksy URI zasobów, które są ładowane, gdy SkipExternalResources jest true, np. https://cdn.example.com/assets/ lub file:///C:/assets/. Domyślnie puste.
  • ExternalResourceHandler — domyślnie null.

Zmiany niekompatybilne wstecz:

  • Zasoby zewnętrzne nie są już ładowane domyślnie. Zasoby zdalne (http, https, ftp i inne schematy), ścieżki UNC, pliki lokalne, w tym pliki w własnym folderze dokumentu, oraz odwołania względne wskazujące poza dokument są pomijane, a operacja jest kontynuowana. Wcześniejsze wersje je ładowały. Zdalne obrazy i arkusze stylów dokumentów HTML, Word i prezentacji mogą więc nie pojawić się w wyniku, a liczba stron dokumentów HTML i Word może się zmienić. Zawartość, którą dokument niesie — URI data:, odwołania cid:, części MHTML i media w pakiecie — nadal jest ładowana. Aby załadować zasoby zewnętrzne, dodaj ich lokalizacje do białej listy lub ustaw SkipExternalResources na false dla zaufanych dokumentów.
  • LoadOptions jest teraz sealed. Klasa dziedzicząca po niej nie kompiluje się. Użyj LoadOptions bezpośrednio lub zaimplementuj ILoadOptions; własna implementacja ILoadOptions, która nie implementuje również IResourceLoadingOptions, otrzymuje domyślną politykę.
  • Wpis WhitelistedResources, który jest null, pusty, nie jest absolutnym URI, zawiera zapytanie lub fragment, lub zawiera %2F, %5C lub %2E, powoduje, że konstruktor Merger rzuca ArgumentException („Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”).
  • Jeśli obsługa zgłosi wyjątek, zasób jest pomijany, a operacja rzuca GroupDocsMergerException („The external resource handler threw an exception; the resource was skipped. See the inner exception.”) z wyjątkiem obsługi jako InnerException.
  • Dokumenty EPUB oraz dokumenty SVG i SVGZ w niektórych operacjach mają teraz sprawdzany markup pod kątem odwołań zewnętrznych. Dokument, którego markup nie jest poprawnym XML, kończy się niepowodzeniem z 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.”).
  • Konstruktory OleDiagramOptions, OleSpreadsheetOptions i OleWordProcessingOptions, które przyjmują ścieżkę pliku i numer strony, renderują obraz osadzonego obiektu z odrzuconymi zasobami zewnętrznymi, niezależnie od tego, co pozwalają LoadOptions dokumentu docelowego. Aby je wyświetlić, przekaż własne dane obrazu do konstruktora, który je przyjmuje.
  • Produkty z pakietu GroupDocs.Merger.LowCode zawsze odrzucają zasoby zewnętrzne.

Opcje są odczytywane podczas tworzenia Merger, a dokumenty dołączane do niego stosują się do tych opcji.

2. Dokumenty PDF z automatycznym tagowaniem zachowują format i tytuł źródła

Brak zmian w API. Dokument PDF zapisany z ustawieniem PdfSaveOptions.AccesibilitySettings.EnableAutoTagging ustawionym na true zachowuje format PDF oraz tytuł źródła. Wcześniej każdy dokument z automatycznym tagowaniem był oznaczany jako PDF/UA-1, a niezatytułowane źródło otrzymywało tytuł „Tagged PDF”. Automatyczne tagowanie dodaje drzewo struktury logicznej; nie sprawia, że dokument jest zgodny z PDF/UA, a źródło już oznaczone jako PDF/UA zachowuje swój znacznik.

3. Dokumenty EPUB o stałym układzie — jedna strona na stronę książki

Brak zmian w API. Dokument EPUB o stałym układzie ma teraz jedną stronę na stronę książki. Wcześniej każda strona książki była renderowana jako dwie strony, więc GetDocumentInfo zgłaszało podwójną liczbę stron, a strona N nie odpowiadała stronie książki N. Numery stron przekazywane do operacji na stronach, takich jak ExtractPages, RemovePages czy Split, odnoszą się teraz do stron książki.

4. GroupDocs.Merger.LowCode — ścieżka wyjściowa i łączone dokumenty

  • JoinPdf, JoinDocx, JoinPptx i RemovePagesPdf rozwiązują względną ścieżkę wyjściową względem bieżącego katalogu roboczego. Ścieżka wyjściowa podana jako sama nazwa pliku jest teraz zapisywana do bieżącego katalogu; wcześniej była zapisywana w domyślnym katalogu wyjściowym Merger. Null lub pusta ścieżka wyjściowa powoduje wyrzucenie ArgumentNullException.
  • JoinPdf, JoinDocx i JoinPptx rzucają FileTypeNotSupportedException, gdy rozszerzenie łączonego dokumentu nie odpowiada formatowi produktu, przed zapisaniem jakiegokolwiek wyjścia, na przykład „Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. Wcześniej JoinPdf i JoinDocx generowały mieszane wyjście, a JoinPptx później zawodziło z innym komunikatem. Null lub pusta ścieżka łączonego dokumentu powoduje wyrzucenie ArgumentNullException („The document at index 0 is null or empty.”).
  • Wszystkie siedem produktów rzucają FileTypeNotSupportedException („Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) dla ścieżki źródłowej bez rozszerzenia, zamiast ArgumentException.

5. Zależności

  • Pakiety uruchomieniowe zależą od System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 i ich pakietów .Windows) lub 9.0.21 (GroupDocs.Merger.Net100 i GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows oraz GroupDocs.Merger.LowCode zależą również od System.Formats.Asn1 8.0.2, a GroupDocs.Merger.LowCode od System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 pozostaje niezmieniony.
  • W projektach .NET Framework pakiet GroupDocs.Merger nie dodaje już przekierowania wiązania dla System.ValueTuple do app.config lub web.config (projekty packages.config), a jego cele kompilacji .NET Framework ustawiają DependsOnNETStandard na true, chyba że projekt to ustawi.

Nowe funkcje

  • Kontrola zasobów zewnętrznych: Zdalne obrazy, arkusze stylów, powiązane obrazy i inne pliki, do których odwołuje się dokument, nie są już ładowane, chyba że je zezwolisz. LoadOptions posiada nowe właściwości SkipExternalResources, WhitelistedResources i ExternalResourceHandler, które pozwalają na zaufane lokalizacje, zezwalają na wszystko dla zaufanych dokumentów lub decydują, pomijają lub dostarczają każdy zasób w własnym kodzie.
  • Poprawki współbieżności: Dokumenty EPUB nie przerywają już działania z NullReferenceException lub IndexOutOfRangeException, a dokumenty TeX nie zgłaszają ArgumentException, gdy są przetwarzane z kilku wątków.
  • Dokumenty EPUB: Dokumenty EPUB o stałym układzie mają teraz jedną stronę na stronę książki, więc strona N jest stroną książki N. Dokumenty EPUB, których plik spisu treści ma inne rozszerzenie niż .ncx, nie przerywają już działania z NullReferenceException.
  • Wyjście PDF z automatycznym tagowaniem: Dokument PDF zapisany z automatycznym tagowaniem zachowuje format i tytuł źródła. Nie jest już oznaczany jako PDF/UA-1, chyba że źródło takie było, a niezatytułowane źródło nie otrzymuje już tytułu „Tagged PDF”.
  • Projekty .NET Framework: Łączenia obrazów w projektach packages.config nie przerywają już ładowania System.ValueTuple, a łączenia z dokumentami SVG nie przerywają już ładowania netstandard w środowiskach .NET Framework 4.6.2‑4.7.0.
  • Zaktualizowana zależność: Pakiety zależą od System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 i .NET 8.0) lub 9.0.21 (.NET 10.0), wersji naprawiających CVE-2026-84008 i CVE-2026-70162.
  • Produkty LowCode: Ścieżka wyjściowa podana jako sama nazwa pliku jest zapisywana do bieżącego katalogu, a JoinPdf, JoinDocx i JoinPptx odrzucają łączony dokument innego formatu przed zapisaniem jakiegokolwiek wyjścia.

Przykład kodu

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
        }
    }
}

Jak uzyskać aktualizację

NuGet

Uaktualnij do najnowszego pakietu GroupDocs.Merger za pośrednictwem NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

Bezpośrednie pobranie

Pobierz zestawy (assemblies) ze strony GroupDocs.Merger for .NET 26.10 .

Zasoby