We’re happy to announce the release of GroupDocs.Merger for .NET v26.10, available as of October 2026. This release introduces major enhancements for controlling external resource loading, resolves critical concurrency issues in EPUB and TeX processing, improves EPUB pagination, preserves PDF format and title in auto-tagged output, and fixes several .NET Framework–related failures. Overall, it includes 10 features, improvements, and bug fixes.
Wat is nieuw in deze release
- [Functie] Standaard het laden van externe bronnen overslaan, met een witlijst van vertrouwde locaties en een per‑bron handler
- [Bug] NullReferenceException verhelpen voor EPUB‑documenten waarvan het inhoudsopgave‑bestand niet de .ncx‑extensie heeft
- [Bug] Het falen van afbeelding‑samenvoegingen bij het laden van System.ValueTuple in .NET Framework‑packages.config‑projecten verhelpen
- [Bug] Het falen van samenvoegingen met SVG‑documenten op .NET Framework 4.6.2 tot 4.7.0 runtimes verhelpen
- [Bug] Fixed‑layout EPUB‑pagina’s één per boekpagina renderen in plaats van elke pagina in tweeën te splitsen
- [Bug] System.Security.Cryptography.Pkcs bijwerken naar 8.0.2 en 9.0.21 (CVE-2026-84008, CVE-2026-70162)
- [Bug] Het originele PDF‑formaat en de titel behouden bij opslaan met auto‑tagging ingeschakeld
- [Bug] Een ArgumentException verhelpen wanneer TeX‑documenten gelijktijdig worden geladen
- [Bug] LowCode‑output die als een losse bestandsnaam wordt opgegeven opslaan in de huidige map en samengevoegde documenten van een ander formaat afwijzen
- [Bug] EPUB‑documenten die af en toe falen met NullReferenceException of IndexOutOfRangeException bij gelijktijdige verwerking verhelpen
Wijzigingen in de openbare API
1. Externe bronnen — standaard geweigerd (nieuwe API, niet‑achterwaarts compatibel)
Nieuwe openbare types in de GroupDocs.Merger.Domain.Options namespace:
| Type | Description |
|---|---|
| IResourceLoadingOptions | Definieert SkipExternalResources, WhitelistedResources en ExternalResourceHandler. LoadOptions implementeert het. |
| IExternalResourceHandler | De OnLoading‑methode wordt aangeroepen voor elke externe bron voordat deze wordt geladen en kan deze toestaan, overslaan of vervangen. |
| ExternalResourceLoadingArgs | De bron die aan OnLoading wordt doorgegeven: Uri, Skipped (vooraf ingesteld op de beslissing van de andere twee opties) en Data (inhoud die in plaats van het laden van de bron wordt gebruikt). |
Nieuwe eigenschappen van LoadOptions:
SkipExternalResources— standaardtruein elke constructor. Terwijltrue, wordt geen externe bron geladen behalve diegene die overeenkomt metWhitelistedResourcesof door de handler is toegestaan.WhitelistedResources— absolute URI‑prefixen van bronnen die worden geladen terwijlSkipExternalResourcestrueis, bijvoorbeeldhttps://cdn.example.com/assets/offile:///C:/assets/. Standaard leeg.ExternalResourceHandler— standaardnull.
Niet‑achterwaarts compatibele wijzigingen:
- Externe bronnen worden niet langer standaard geladen. Externe bronnen (
http,https,ftpen andere schema’s), UNC‑paden, lokale bestanden, inclusief bestanden in de eigen map van het document, en relatieve verwijzingen die buiten het document wijzen, worden overgeslagen en de bewerking gaat verder. Eerdere versies laadden ze. Externe afbeeldingen en stylesheets van HTML-, Word- en presentatiedocumenten kunnen daardoor ontbreken in de output, en het paginatelling van HTML- en Word‑documenten kan veranderen. Inhoud die het document draagt —data:‑URI’s,cid:‑referenties, MHTML‑onderdelen en verpakte media — wordt nog steeds geladen. Om externe bronnen te laden, zet je hun locaties op de witlijst, of stel jeSkipExternalResourcesin opfalsevoor documenten die je vertrouwt. LoadOptionsis nusealed. Een klasse die ervan afgeleid is, compileert niet meer. GebruikLoadOptionsdirect, of implementeerILoadOptions; een aangepasteILoadOptions‑implementatie die niet ookIResourceLoadingOptionsimplementeert, krijgt het standaardbeleid.- Een
WhitelistedResources‑item dat null, leeg, geen absolute URI is, een query of fragment bevat, of%2F,%5Cof%2Ebevat, zorgt ervoor dat deMerger‑constructor eenArgumentExceptiongooit (“Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.”). - Als de handler een uitzondering gooit, wordt de bron overgeslagen en gooit de bewerking een
GroupDocsMergerException(“The external resource handler threw an exception; the resource was skipped. See the inner exception.”) met de uitzondering van de handler alsInnerException. - EPUB‑documenten, en SVG‑ en SVGZ‑documenten in sommige bewerkingen, hebben nu hun markup gecontroleerd op externe verwijzingen. Een document waarvan de markup geen goed gevormde XML is, faalt met
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.”). - De constructors van
OleDiagramOptions,OleSpreadsheetOptionsenOleWordProcessingOptionsdie een bestandspad en een paginanummer ontvangen, renderen de afbeelding van het ingesloten object met externe bronnen geweigerd, ongeacht wat deLoadOptionsvan het doel‑document toestaat. Om ze te tonen, geef je je eigen afbeeldingsdata door aan de constructor die dit accepteert. - De producten van het
GroupDocs.Merger.LowCode‑pakket weigeren altijd externe bronnen.
De opties worden gelezen wanneer de Merger wordt aangemaakt, en documenten die eraan worden toegevoegd volgen deze opties.
2. Auto‑getagde PDF‑documenten behouden het formaat en de titel van de bron
Geen API‑wijziging. Een PDF‑document dat wordt opgeslagen met PdfSaveOptions.AccesibilitySettings.EnableAutoTagging ingesteld op true behoudt het PDF‑formaat en de titel van de bron. Voorheen werd elk auto‑getagd document gemarkeerd als PDF/UA-1, en kreeg een naamloze bron de titel “Tagged PDF”. Auto‑tagging voegt een logische structuurboom toe; het maakt een document niet PDF/UA‑conform, en een bron die al gemarkeerd is als PDF/UA behoudt zijn markering.
3. Fixed‑layout EPUB‑documenten — één pagina per boekpagina
Geen API‑wijziging. Een fixed‑layout EPUB‑document heeft nu één pagina per boekpagina. Voorheen werd elke boekpagina als twee pagina’s gerenderd, waardoor GetDocumentInfo het dubbele aantal pagina’s rapporteerde en pagina N niet overeenkwam met de boekpagina N. Paginanummers die worden doorgegeven aan paginabewerkingen zoals ExtractPages, RemovePages of Split verwijzen nu naar de boekpagina’s.
4. GroupDocs.Merger.LowCode — uitvoerpad en samengevoegde documenten
JoinPdf,JoinDocx,JoinPptxenRemovePagesPdflossen een relatief uitvoerpad op ten opzichte van de huidige werkmap. Een uitvoerpad dat als een losse bestandsnaam wordt opgegeven, wordt nu opgeslagen in de huidige map; voorheen werd het opgeslagen in de standaard uitvoermap van Merger. Een null of leeg uitvoerpad gooitArgumentNullException.JoinPdf,JoinDocxenJoinPptxgooienFileTypeNotSupportedExceptionwanneer de extensie van een samengevoegd document niet overeenkomt met het formaat van het product, voordat er output wordt geschreven, bijvoorbeeld “Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.”. Voorheen produceerdenJoinPdfenJoinDocxgemengde output enJoinPptxfaalde later met een andere melding. Een null of leeg pad van een samengevoegd document gooitArgumentNullException(“The document at index 0 is null or empty.”).- Alle zeven producten gooien
FileTypeNotSupportedException(“Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.”) voor een bronpad zonder extensie, in plaats vanArgumentException.
5. Afhankelijkheden
- De runtime‑pakketten zijn afhankelijk van System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80en hun.Windows‑pakketten) of 9.0.21 (GroupDocs.Merger.Net100enGroupDocs.Merger.Net100.Windows).GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowsenGroupDocs.Merger.LowCodezijn ook afhankelijk van System.Formats.Asn1 8.0.2, enGroupDocs.Merger.LowCodevan System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462blijft ongewijzigd. - In .NET Framework‑projecten voegt het
GroupDocs.Merger‑pakket geen binding‑redirect meer toe voor System.ValueTuple naarapp.configofweb.config(packages.config‑projecten), en stellen de .NET Framework‑buildtargetsDependsOnNETStandardin optruetenzij het project dit instelt.
Nieuwe functies
- Beheer van externe bronnen: Externe afbeeldingen, stylesheets, gekoppelde afbeeldingen en andere bestanden die een document verwijst, worden niet langer geladen tenzij je ze toestaat.
LoadOptionsheeft nieuwe eigenschappenSkipExternalResources,WhitelistedResourcesenExternalResourceHandlerom vertrouwde locaties toe te staan, alles toe te staan voor documenten die je vertrouwt, of om per bron te beslissen, over te slaan of te leveren in je eigen code. - Gelijktijdigheidsoplossingen: EPUB‑documenten falen niet langer af en toe met
NullReferenceExceptionofIndexOutOfRangeException, en TeX‑documenten metArgumentException, wanneer ze vanuit meerdere threads worden verwerkt. - EPUB‑documenten: Fixed‑layout EPUB‑documenten hebben nu één pagina per boekpagina, dus pagina N is de boekpagina N. EPUB‑documenten waarvan het inhoudsopgave‑bestand een andere extensie dan
.ncxheeft, falen niet langer metNullReferenceException. - Auto‑getagde PDF‑output: Een PDF‑document dat wordt opgeslagen met auto‑tagging behoudt het formaat en de titel van de bron. Het wordt niet langer gemarkeerd als PDF/UA-1 tenzij de bron dat was, en een naamloze bron krijgt niet langer de titel “Tagged PDF”.
- .NET Framework‑projecten: Afbeeldings‑samenvoegingen in packages.config‑projecten falen niet langer bij het laden van System.ValueTuple, en samenvoegingen met SVG‑documenten falen niet langer bij het laden van netstandard op .NET Framework 4.6.2 tot 4.7.0 runtimes.
- Gepatchte afhankelijkheid: De pakketten zijn afhankelijk van System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 en .NET 8.0) of 9.0.21 (.NET 10.0), de versies die CVE-2026-84008 en CVE-2026-70162 verhelpen.
- LowCode‑producten: Een uitvoerpad dat als een losse bestandsnaam wordt opgegeven, wordt opgeslagen in de huidige map, en
JoinPdf,JoinDocxenJoinPptxwijzen een samengevoegd document van een ander formaat af voordat er output wordt geschreven.
Codevoorbeeld
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
}
}
}
Hoe de update te verkrijgen
NuGet
Upgrade naar het nieuwste GroupDocs.Merger‑pakket via NuGet: GroupDocs.Merger 26.10.0
dotnet add package GroupDocs.Merger --version 26.10.0
Directe download
Download assemblies van de GroupDocs.Merger for .NET 26.10 pagina.