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ítruev každém konstruktoru. Pokud jetrue, žádný externí zdroj není načten kromě těch, které odpovídajíWhitelistedResourcesnebo jsou povoleny obslužnou funkcí.WhitelistedResources— absolutní předpony URI zdrojů, které jsou načteny, když jeSkipExternalResourcesnastaveno natrue, např.https://cdn.example.com/assets/nebofile:///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,ftpa 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 nastavteSkipExternalResourcesnafalseu dokumentů, kterým důvěřujete. LoadOptionsje nynísealed. Třída odvozená od ní již není kompilovatelná. PoužívejteLoadOptionspřímo, nebo implementujteILoadOptions; vlastní implementaceILoadOptions, která zároveň neimplementujeIResourceLoadingOptions, získá výchozí politiku.- Položka
WhitelistedResources, která je null, prázdná, není absolutní URI, obsahuje dotaz nebo fragment, nebo obsahuje%2F,%5Cnebo%2E, způsobí, že konstruktorMergervyhodí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 jakoInnerException. - 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,OleSpreadsheetOptionsaOleWordProcessingOptions, 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, coLoadOptionscí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.LowCodevž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,JoinPptxaRemovePagesPdfř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,JoinDocxaJoinPptxvyvolají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říveJoinPdfaJoinDocxvytvářely smíšený výstup aJoinPptxselhal 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ístoArgumentException.
5. Závislosti
- Běhové balíčky závisí na System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80a jejich.Windowsbalíčcích) nebo 9.0.21 (GroupDocs.Merger.Net100aGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowsaGroupDocs.Merger.LowCodetaké závisí na System.Formats.Asn1 8.0.2 aGroupDocs.Merger.LowCodena System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462zůstává beze změny. - V projektech .NET Framework balíček
GroupDocs.Mergerjiž nepřidává binding redirect pro System.ValueTuple doapp.configneboweb.config(projekty s packages.config) a jeho .NET Framework build targety nastavujíDependsOnNETStandardnatrue, 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.
LoadOptionsmá nové vlastnostiSkipExternalResources,WhitelistedResourcesaExternalResourceHandler, 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
NullReferenceExceptionneboIndexOutOfRangeExceptiona TeX dokumenty sArgumentException, 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 sNullReferenceException. - 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,JoinDocxaJoinPptxodmí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 .