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ślnietruew każdym konstruktorze. Gdy jesttrue, żaden zasób zewnętrzny nie jest ładowany, z wyjątkiem tych pasujących doWhitelistedResourceslub dozwolonych przez obsługę.WhitelistedResources— absolutne prefiksy URI zasobów, które są ładowane, gdySkipExternalResourcesjesttrue, np.https://cdn.example.com/assets/lubfile:///C:/assets/. Domyślnie puste.ExternalResourceHandler— domyślnienull.
Zmiany niekompatybilne wstecz:
- Zasoby zewnętrzne nie są już ładowane domyślnie. Zasoby zdalne (
http,https,ftpi 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 — URIdata:, odwołaniacid:, części MHTML i media w pakiecie — nadal jest ładowana. Aby załadować zasoby zewnętrzne, dodaj ich lokalizacje do białej listy lub ustawSkipExternalResourcesnafalsedla zaufanych dokumentów. LoadOptionsjest terazsealed. Klasa dziedzicząca po niej nie kompiluje się. UżyjLoadOptionsbezpośrednio lub zaimplementujILoadOptions; własna implementacjaILoadOptions, 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,%5Club%2E, powoduje, że konstruktorMergerrzucaArgumentException(„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 jakoInnerException. - 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,OleSpreadsheetOptionsiOleWordProcessingOptions, które przyjmują ścieżkę pliku i numer strony, renderują obraz osadzonego obiektu z odrzuconymi zasobami zewnętrznymi, niezależnie od tego, co pozwalająLoadOptionsdokumentu docelowego. Aby je wyświetlić, przekaż własne dane obrazu do konstruktora, który je przyjmuje. - Produkty z pakietu
GroupDocs.Merger.LowCodezawsze 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,JoinPptxiRemovePagesPdfrozwią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 wyrzucenieArgumentNullException.JoinPdf,JoinDocxiJoinPptxrzucają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śniejJoinPdfiJoinDocxgenerowały mieszane wyjście, aJoinPptxpóźniej zawodziło z innym komunikatem. Null lub pusta ścieżka łączonego dokumentu powoduje wyrzucenieArgumentNullException(„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, zamiastArgumentException.
5. Zależności
- Pakiety uruchomieniowe zależą od System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80i ich pakietów.Windows) lub 9.0.21 (GroupDocs.Merger.Net100iGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowsorazGroupDocs.Merger.LowCodezależą również od System.Formats.Asn1 8.0.2, aGroupDocs.Merger.LowCodeod System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462pozostaje niezmieniony. - W projektach .NET Framework pakiet
GroupDocs.Mergernie dodaje już przekierowania wiązania dla System.ValueTuple doapp.configlubweb.config(projekty packages.config), a jego cele kompilacji .NET Framework ustawiająDependsOnNETStandardnatrue, 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.
LoadOptionsposiada nowe właściwościSkipExternalResources,WhitelistedResourcesiExternalResourceHandler, 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
NullReferenceExceptionlubIndexOutOfRangeException, 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 zNullReferenceException. - 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,JoinDocxiJoinPptxodrzucają łą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 .