Jsme rádi, že můžeme oznámit vydání GroupDocs.Merger for .NET v26.10, dostupné od října 2026. Toto vydání přináší významná vylepšení pro řízení načítání externích zdrojů, řeší kritické problémy souběžnosti při zpracování EPUB a TeX, zlepšuje stránkování EPUB, zachovává formát PDF a název v automaticky označeném výstupu a opravuje několik selhání souvisejících s .NET Framework. Celkem obsahuje 10 funkcí, vylepšení a oprav chyb.

Co je nového v tomto vydání

  • [Feature] Přeskočit načítání externích zdrojů ve výchozím nastavení, s whitelistem důvěryhodných umístění a obslužnou funkcí pro každý zdroj
  • [Bug] Opravit NullReferenceException u EPUB dokumentů, jejichž soubor obsahu nemá příponu .ncx
  • [Bug] Opravit selhání spojování obrázků při načítání System.ValueTuple v projektech .NET Framework s packages.config
  • [Bug] Opravit selhání spojování se SVG dokumenty na runtime .NET Framework 4.6.2 až 4.7.0
  • [Bug] Vykreslovat stránky pevného rozvržení EPUB po jedné na stránku knihy místo rozdělení každé na dvě
  • [Bug] Aktualizovat System.Security.Cryptography.Pkcs na 8.0.2 a 9.0.21 (CVE-2026-84008, CVE-2026-70162)
  • [Bug] Zachovat původní formát PDF a název při ukládání s povoleným automatickým označováním
  • [Bug] Opravit ArgumentException při souběžném načítání TeX dokumentů
  • [Bug] Uložit výstup LowCode zadaný jako pouhý název souboru do aktuálního adresáře a odmítnout spojené dokumenty jiného formátu
  • [Bug] Opravit intermitentní selhání EPUB dokumentů s NullReferenceException nebo IndexOutOfRangeException při souběžném zpracování

Změny veřejného API

1. Externí zdroje — zakázány ve výchozím nastavení (nové API, nekompatibilní zpětně)

Nové veřejné typy v namespace GroupDocs.Merger.Domain.Options:

Typ Popis
IResourceLoadingOptions Definuje SkipExternalResources, WhitelistedResources a ExternalResourceHandler. LoadOptions jej implementuje.
IExternalResourceHandler Jeho metoda OnLoading je volána pro každý externí zdroj před jeho načtením a může jej povolit, přeskočit nebo nahradit.
ExternalResourceLoadingArgs Zdroj předaný metodě OnLoading: Uri, Skipped (přednastaveno podle rozhodnutí dvou předchozích možností) a Data (obsah, který se použije místo načtení zdroje).

Nové vlastnosti třídy LoadOptions:

  • SkipExternalResources — ve výchozím nastavení true v každém konstruktoru. Pokud je true, žádný externí zdroj není načten kromě těch, které odpovídají WhitelistedResources nebo jsou povoleny obslužnou funkcí.
  • WhitelistedResources — absolutní předpony URI zdrojů, které jsou načteny, když je SkipExternalResources nastaveno na true, např. https://cdn.example.com/assets/ nebo file:///C:/assets/. Ve výchozím nastavení prázdné.
  • ExternalResourceHandler — ve výchozím nastavení null.

Změny nekompatibilní zpětně:

  • Externí zdroje již nejsou ve výchozím nastavení načítány. Vzdálené zdroje (http, https, ftp a další schémata), UNC cesty, lokální soubory, včetně souborů ve složce dokumentu, a relativní odkazy směřující mimo dokument jsou přeskočeny a operace pokračuje. Předchozí verze je načítaly. Vzdálené obrázky a styly HTML, Word a prezentačních dokumentů tak mohou chybět ve výstupu a počet stránek HTML a Word dokumentů se může změnit. Obsah, který dokument nese — data: URI, cid: odkazy, MHTML části a zabalená média — se stále načítá. Pro načtení externích zdrojů přidejte jejich umístění na whitelist nebo nastavte SkipExternalResources na false u dokumentů, kterým důvěřujete.
  • LoadOptions je nyní sealed. Třída odvozená od ní již není kompilovatelná. Používejte LoadOptions přímo, nebo implementujte ILoadOptions; vlastní implementace ILoadOptions, která zároveň neimplementuje IResourceLoadingOptions, získá výchozí politiku.
  • Položka WhitelistedResources, která je null, prázdná, není absolutní URI, obsahuje dotaz nebo fragment, nebo obsahuje %2F, %5C nebo %2E, způsobí, že konstruktor Merger vyhodí ArgumentException („Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.“).
  • Pokud obslužná funkce vyhodí výjimku, zdroj je přeskočen a operace vyhodí GroupDocsMergerException („The external resource handler threw an exception; the resource was skipped. See the inner exception.“) s výjimkou obslužné funkce jako InnerException.
  • EPUB dokumenty a SVG a SVGZ dokumenty v některých operacích nyní mají svůj markup kontrolován na externí odkazy. Dokument, jehož markup není dobře formovaný XML, selže s 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.“).
  • Konstruktor OleDiagramOptions, OleSpreadsheetOptions a OleWordProcessingOptions, které přijímají cestu k souboru a číslo stránky, vykreslují obrázek vloženého objektu s externími zdroji zakázanými, bez ohledu na to, co LoadOptions cílového dokumentu povolují. Pro jejich zobrazení předávejte vlastní data obrázku do konstruktoru, který je přijímá.
  • Produkty balíčku GroupDocs.Merger.LowCode vždy zakazují externí zdroje.

Možnosti jsou načteny při vytvoření instance Merger a dokumenty k ní připojené používají její nastavení.

2. Automaticky označené PDF dokumenty zachovávají formát a název zdroje

Žádná změna API. PDF dokument uložený s nastavením PdfSaveOptions.AccesibilitySettings.EnableAutoTagging nastaveným na true zachovává formát PDF a název zdroje. Dříve byl každý automaticky označený dokument označen jako PDF/UA-1 a nepojmenovaný zdroj získal název „Tagged PDF“. Automatické označování přidává logický strom struktury; neznamená to, že je dokument v souladu s PDF/UA, a zdroj, který je již označen jako PDF/UA, si své označení ponechává.

3. EPUB dokumenty s pevnou rozvržením — jedna stránka na stránku knihy

Žádná změna API. EPUB dokument s pevnou rozvržením nyní má jednu stránku na stránku knihy. Dříve byla každá stránka knihy vykreslena jako dvě stránky, takže GetDocumentInfo hlásil dvojnásobný počet stránek a stránka N neodpovídala stránce knihy N. Čísla stránek předávaná operacím jako ExtractPages, RemovePages nebo Split nyní odkazují na stránky knihy.

4. GroupDocs.Merger.LowCode — výstupní cesta a spojené dokumenty

  • JoinPdf, JoinDocx, JoinPptx a RemovePagesPdf řeší relativní výstupní cestu vůči aktuálnímu pracovnímu adresáři. Výstupní cesta zadaná jako pouhý název souboru je nyní uložena do aktuálního adresáře; dříve byla uložena do výchozího výstupního adresáře Mergeru. Null nebo prázdná výstupní cesta vyvolá ArgumentNullException.
  • JoinPdf, JoinDocx a JoinPptx vyvolají FileTypeNotSupportedException, když má spojený dokument příponu, která neodpovídá formátu produktu, ještě před zápisem jakéhokoli výstupu, např. „Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.“. Dříve JoinPdf a JoinDocx vytvářely smíšený výstup a JoinPptx selhal později s jinou zprávou. Null nebo prázdná cesta spojeného dokumentu vyvolá ArgumentNullException („The document at index 0 is null or empty.“).
  • Všech sedm produktů vyvolá FileTypeNotSupportedException („Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.“) pro zdrojovou cestu bez přípony, místo ArgumentException.

5. Závislosti

  • Běhové balíčky závisí na System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 a jejich .Windows balíčcích) nebo 9.0.21 (GroupDocs.Merger.Net100 a GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows a GroupDocs.Merger.LowCode také závisí na System.Formats.Asn1 8.0.2 a GroupDocs.Merger.LowCode na System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 zůstává beze změny.
  • V projektech .NET Framework balíček GroupDocs.Merger již nepřidává binding redirect pro System.ValueTuple do app.config nebo web.config (projekty s packages.config) a jeho .NET Framework build targety nastavují DependsOnNETStandard na true, pokud to projekt nenastaví.

Nové funkce

  • Řízení externích zdrojů: Vzdálené obrázky, styly, propojené obrázky a další soubory, na které dokument odkazuje, již nejsou načítány, pokud je nepovolíte. LoadOptions má nové vlastnosti SkipExternalResources, WhitelistedResources a ExternalResourceHandler, které umožňují povolit důvěryhodná umístění, povolit vše pro dokumenty, kterým důvěřujete, nebo rozhodnout, přeskočit či dodat každý zdroj ve vašem kódu.
  • Opravy souběžnosti: EPUB dokumenty již nepadnou intermitentně s NullReferenceException nebo IndexOutOfRangeException a TeX dokumenty s ArgumentException, když jsou zpracovávány z několika vláken.
  • EPUB dokumenty: EPUB dokumenty s pevnou rozvržením nyní mají jednu stránku na stránku knihy, takže stránka N je stránka knihy N. EPUB dokumenty, jejichž soubor obsahu má jinou příponu než .ncx, již nepadnou s NullReferenceException.
  • Výstup automaticky označeného PDF: PDF dokument uložený s automatickým označováním zachovává formát a název zdroje. Už není označen jako PDF/UA-1, pokud zdroj nebyl, a nepojmenovaný zdroj již nedostává název „Tagged PDF“.
  • Projekty .NET Framework: Spojování obrázků v projektech s packages.config již nehlásí selhání načtení System.ValueTuple a spojování se SVG dokumenty již nehlásí selhání načtení netstandard na runtime .NET Framework 4.6.2 až 4.7.0.
  • Opravená závislost: Balíčky závisí na System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 a .NET 8.0) nebo 9.0.21 (.NET 10.0), verzích, které opravují CVE-2026-84008 a CVE-2026-70162.
  • LowCode produkty: Výstupní cesta zadaná jako pouhý název souboru je uložena do aktuálního adresáře a JoinPdf, JoinDocx a JoinPptx odmítají spojený dokument jiného formátu před zápisem jakéhokoli výstupu.

Příklad kódu

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 získat aktualizaci

NuGet

Aktualizujte na nejnovější balíček GroupDocs.Merger přes NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

Přímé stažení

Stáhněte sestavy ze stránky GroupDocs.Merger for .NET 26.10 .

Zdroje