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 — standaard true in elke constructor. Terwijl true, wordt geen externe bron geladen behalve diegene die overeenkomt met WhitelistedResources of door de handler is toegestaan.
  • WhitelistedResources — absolute URI‑prefixen van bronnen die worden geladen terwijl SkipExternalResources true is, bijvoorbeeld https://cdn.example.com/assets/ of file:///C:/assets/. Standaard leeg.
  • ExternalResourceHandler — standaard null.

Niet‑achterwaarts compatibele wijzigingen:

  • Externe bronnen worden niet langer standaard geladen. Externe bronnen (http, https, ftp en 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 je SkipExternalResources in op false voor documenten die je vertrouwt.
  • LoadOptions is nu sealed. Een klasse die ervan afgeleid is, compileert niet meer. Gebruik LoadOptions direct, of implementeer ILoadOptions; een aangepaste ILoadOptions‑implementatie die niet ook IResourceLoadingOptions implementeert, krijgt het standaardbeleid.
  • Een WhitelistedResources‑item dat null, leeg, geen absolute URI is, een query of fragment bevat, of %2F, %5C of %2E bevat, zorgt ervoor dat de Merger‑constructor een ArgumentException gooit (“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 als InnerException.
  • 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, OleSpreadsheetOptions en OleWordProcessingOptions die een bestandspad en een paginanummer ontvangen, renderen de afbeelding van het ingesloten object met externe bronnen geweigerd, ongeacht wat de LoadOptions van 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, JoinPptx en RemovePagesPdf lossen 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 gooit ArgumentNullException.
  • JoinPdf, JoinDocx en JoinPptx gooien FileTypeNotSupportedException wanneer 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 produceerden JoinPdf en JoinDocx gemengde output en JoinPptx faalde later met een andere melding. Een null of leeg pad van een samengevoegd document gooit ArgumentNullException (“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 van ArgumentException.

5. Afhankelijkheden

  • De runtime‑pakketten zijn afhankelijk van System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 en hun .Windows‑pakketten) of 9.0.21 (GroupDocs.Merger.Net100 en GroupDocs.Merger.Net100.Windows). GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows en GroupDocs.Merger.LowCode zijn ook afhankelijk van System.Formats.Asn1 8.0.2, en GroupDocs.Merger.LowCode van System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 blijft ongewijzigd.
  • In .NET Framework‑projecten voegt het GroupDocs.Merger‑pakket geen binding‑redirect meer toe voor System.ValueTuple naar app.config of web.config (packages.config‑projecten), en stellen de .NET Framework‑buildtargets DependsOnNETStandard in op true tenzij 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. LoadOptions heeft nieuwe eigenschappen SkipExternalResources, WhitelistedResources en ExternalResourceHandler om 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 NullReferenceException of IndexOutOfRangeException, en TeX‑documenten met ArgumentException, 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 .ncx heeft, falen niet langer met NullReferenceException.
  • 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, JoinDocx en JoinPptx wijzen 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.

Bronnen