Wir freuen uns, die Veröffentlichung von GroupDocs.Merger for .NET v26.10 bekannt zu geben, verfügbar seit Oktober 2026. Dieses Release führt wesentliche Verbesserungen zur Steuerung des Ladens externer Ressourcen ein, behebt kritische Parallelitätsprobleme bei der Verarbeitung von EPUB- und TeX-Dokumenten, verbessert die EPUB-Paginierung, bewahrt das PDF-Format und den Titel in automatisch getaggten Ausgaben und behebt mehrere .NET Framework‑bezogene Fehler. Insgesamt umfasst es 10 Funktionen, Verbesserungen und Fehlerbehebungen.

Was ist neu in diesem Release

  • [Feature] Standardmäßig das Laden externer Ressourcen überspringen, mit einer Whitelist vertrauenswürdiger Orte und einem pro‑Ressourcen‑Handler
  • [Bug] NullReferenceException für EPUB-Dokumente beheben, deren Inhaltsverzeichnisdatei nicht die .ncx-Erweiterung hat
  • [Bug] Bild‑Zusammenführungen, die das Laden von System.ValueTuple in .NET Framework packages.config‑Projekten fehlschlagen, beheben
  • [Bug] Zusammenführungen mit SVG-Dokumenten, die auf .NET Framework 4.6.2 bis 4.7.0 Laufzeiten fehlschlagen, beheben
  • [Bug] Festlayout‑EPUB‑Seiten ein pro Buchseite rendern, anstatt jede in zwei zu teilen
  • [Bug] System.Security.Cryptography.Pkcs auf 8.0.2 und 9.0.21 aktualisieren (CVE-2026-84008, CVE-2026-70162)
  • [Bug] Das ursprüngliche PDF-Format und den Titel beibehalten, wenn mit aktiviertem Auto‑Tagging gespeichert wird
  • [Bug] ArgumentException beheben, wenn TeX-Dokumente gleichzeitig geladen werden
  • [Bug] LowCode‑Ausgabe, die als einfacher Dateiname angegeben wird, im aktuellen Verzeichnis speichern und zusammengeführte Dokumente eines anderen Formats ablehnen
  • [Bug] EPUB-Dokumente, die bei gleichzeitiger Verarbeitung intermittierend mit NullReferenceException oder IndexOutOfRangeException fehlschlagen, beheben

Änderungen an der öffentlichen API

1. Externe Ressourcen — standardmäßig verweigert (neue API, nicht rückwärtskompatibel)

Neue öffentliche Typen im Namespace GroupDocs.Merger.Domain.Options:

Type Description
IResourceLoadingOptions Definiert SkipExternalResources, WhitelistedResources und ExternalResourceHandler. LoadOptions implementiert es.
IExternalResourceHandler Seine OnLoading‑Methode wird für jede externe Ressource vor dem Laden aufgerufen und kann sie zulassen, überspringen oder ersetzen.
ExternalResourceLoadingArgs Die an OnLoading übergebene Ressource: Uri, Skipped (vorab auf die Entscheidung der beiden anderen Optionen gesetzt) und Data (Inhalt, der anstelle des Ladens der Ressource verwendet wird).

Neue Eigenschaften von LoadOptions:

  • SkipExternalResources — standardmäßig true in jedem Konstruktor. Solange true, wird keine externe Ressource geladen, außer solche, die WhitelistedResources entsprechen oder vom Handler erlaubt werden.
  • WhitelistedResources — absolute URI‑Präfixe von Ressourcen, die geladen werden, während SkipExternalResources true ist, z. B. https://cdn.example.com/assets/ oder file:///C:/assets/. Standardmäßig leer.
  • ExternalResourceHandler — standardmäßig null.

Rückwärtsinkompatible Änderungen:

  • Externe Ressourcen werden standardmäßig nicht mehr geladen. Remote‑Ressourcen (http, https, ftp und andere Schemas), UNC‑Pfade, lokale Dateien, einschließlich Dateien im eigenen Ordner des Dokuments, und relative Verweise, die außerhalb des Dokuments zeigen, werden übersprungen und die Operation wird fortgesetzt. Frühere Versionen haben sie geladen. Remote‑Bilder und Stylesheets von HTML-, Word- und Präsentationsdokumenten können daher im Ergebnis fehlen, und die Seitenzahl von HTML- und Word-Dokumenten kann sich ändern. Inhalte, die das Dokument trägt — data:‑URIs, cid:‑Referenzen, MHTML‑Teile und verpackte Medien — werden weiterhin geladen. Um externe Ressourcen zu laden, fügen Sie deren Standorte zur Whitelist hinzu oder setzen Sie SkipExternalResources auf false für Dokumente, denen Sie vertrauen.
  • LoadOptions ist jetzt sealed. Eine davon abgeleitete Klasse lässt sich nicht mehr kompilieren. Verwenden Sie LoadOptions direkt oder implementieren Sie ILoadOptions; eine benutzerdefinierte ILoadOptions‑Implementierung, die nicht auch IResourceLoadingOptions implementiert, erhält die Standard‑Richtlinie.
  • Ein WhitelistedResources‑Eintrag, der null, leer, keine absolute URI ist, eine Abfrage oder ein Fragment enthält oder %2F, %5C oder %2E enthält, lässt den Merger‑Konstruktor ArgumentException werfen („Whitelisted resource ‘…’ must be an absolute URI without a query, fragment or encoded ‘/’, ‘\’ or ‘.’.“).
  • Wenn der Handler eine Ausnahme wirft, wird die Ressource übersprungen und die Operation wirft GroupDocsMergerException („The external resource handler threw an exception; the resource was skipped. See the inner exception.“) mit der Ausnahme des Handlers als InnerException.
  • EPUB‑Dokumente sowie SVG‑ und SVGZ‑Dokumente in einigen Vorgängen werden nun auf externe Verweise im Markup geprüft. Ein Dokument, dessen Markup kein wohlgeformtes XML ist, schlägt mit GroupDocsMergerException fehl („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.“).
  • Die Konstruktoren von OleDiagramOptions, OleSpreadsheetOptions und OleWordProcessingOptions, die einen Dateipfad und eine Seitenzahl erhalten, rendern das Bild des eingebetteten Objekts mit verweigerten externen Ressourcen, unabhängig davon, was die LoadOptions des Ziel Dokuments erlauben. Um sie anzuzeigen, übergeben Sie Ihre eigenen Bilddaten an den entsprechenden Konstruktor.
  • Die Produkte des GroupDocs.Merger.LowCode‑Pakets verweigern immer externe Ressourcen.

Die Optionen werden beim Erstellen des Merger gelesen, und an ihn angefügte Dokumente übernehmen seine Optionen.

2. Auto-getaggte PDF-Dokumente behalten das Format und den Titel der Quelle

Keine API‑Änderung. Ein PDF‑Dokument, das mit PdfSaveOptions.AccesibilitySettings.EnableAutoTagging auf true gespeichert wird, behält das PDF‑Format und den Titel der Quelle. Zuvor wurde jedes auto‑getaggte Dokument als PDF/UA-1 markiert, und eine unbenannte Quelle erhielt den Titel „Tagged PDF“. Auto‑Tagging fügt einen logischen Strukturbaum hinzu; es macht ein Dokument nicht PDF/UA‑konform, und eine Quelle, die bereits als PDF/UA markiert ist, behält diese Markierung bei.

3. Festlayout‑EPUB‑Dokumente — eine Seite pro Buchseite

Keine API‑Änderung. Ein Festlayout‑EPUB‑Dokument hat jetzt eine Seite pro Buchseite. Zuvor wurde jede Buchseite als zwei Seiten gerendert, sodass GetDocumentInfo die doppelte Seitenzahl meldete und Seite N nicht mit der Buchseite N übereinstimmte. Seitenzahlen, die an Seitenoperationen wie ExtractPages, RemovePages oder Split übergeben werden, beziehen sich nun auf die Buchseiten.

4. GroupDocs.Merger.LowCode — Ausgabepfad und zusammengeführte Dokumente

  • JoinPdf, JoinDocx, JoinPptx und RemovePagesPdf lösen einen relativen Ausgabepfad relativ zum aktuellen Arbeitsverzeichnis auf. Ein als einfacher Dateiname angegebener Ausgabepfad wird nun im aktuellen Verzeichnis gespeichert; zuvor wurde er im Standard‑Ausgabeverzeichnis von Merger gespeichert. Ein null‑ oder leerer Ausgabepfad wirft ArgumentNullException.
  • JoinPdf, JoinDocx und JoinPptx werfen FileTypeNotSupportedException, wenn die Erweiterung eines zusammengeführten Dokuments nicht dem Format des Produkts entspricht, bevor irgendeine Ausgabe geschrieben wird, z. B. „Input format does not match the expected format ‘PDF’; the joined file ‘a.docx’ is ‘Microsoft Word Open XML Document (.docx)’.“. Zuvor erzeugten JoinPdf und JoinDocx gemischte Ausgaben und JoinPptx schlug später mit einer anderen Meldung fehl. Ein null‑ oder leerer Pfad zu einem zusammengeführten Dokument wirft ArgumentNullException („The document at index 0 is null or empty.“).
  • Alle sieben Produkte werfen FileTypeNotSupportedException („Input format does not match the expected format ‘PDF’; the supplied file is ‘Unknown’.“) für einen Quellpfad ohne Erweiterung, anstelle von ArgumentException.

5. Abhängigkeiten

  • Die Laufzeitpakete hängen von System.Security.Cryptography.Pkcs 8.0.2 (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80 und deren .Windows‑Paketen) oder 9.0.21 (GroupDocs.Merger.Net100 und GroupDocs.Merger.Net100.Windows) ab. GroupDocs.Merger.Net60, GroupDocs.Merger.Net60.Windows und GroupDocs.Merger.LowCode hängen außerdem von System.Formats.Asn1 8.0.2 ab, und GroupDocs.Merger.LowCode von System.Security.Cryptography.Pkcs 8.0.2. GroupDocs.Merger.Net462 bleibt unverändert.
  • In .NET Framework‑Projekten fügt das GroupDocs.Merger‑Paket keine Bindungsumleitung für System.ValueTuple zu app.config oder web.config (packages.config‑Projekte) mehr hinzu, und seine .NET Framework‑Build‑Ziele setzen DependsOnNETStandard auf true, sofern das Projekt dies nicht selbst setzt.

Neue Funktionen

  • Steuerung externer Ressourcen: Remote‑Bilder, Stylesheets, verknüpfte Bilder und andere Dateien, auf die ein Dokument verweist, werden nicht mehr geladen, sofern Sie sie nicht zulassen. LoadOptions verfügt über die neuen Eigenschaften SkipExternalResources, WhitelistedResources und ExternalResourceHandler, um vertrauenswürdige Orte zu erlauben, alles für vertrauenswürdige Dokumente zu erlauben oder jede Ressource in Ihrem eigenen Code zu entscheiden, zu überspringen oder bereitzustellen.
  • Parallelitätskorrekturen: EPUB‑Dokumente schlagen nicht mehr intermittierend mit NullReferenceException oder IndexOutOfRangeException fehl, und TeX‑Dokumente mit ArgumentException, wenn sie von mehreren Threads verarbeitet werden.
  • EPUB‑Dokumente: Festlayout‑EPUB‑Dokumente haben jetzt eine Seite pro Buchseite, sodass Seite N die Buchseite N ist. EPUB‑Dokumente, deren Inhaltsverzeichnisdatei eine andere Erweiterung als .ncx hat, schlagen nicht mehr mit NullReferenceException fehl.
  • Auto‑getaggte PDF‑Ausgabe: Ein PDF‑Dokument, das mit Auto‑Tagging gespeichert wird, behält das Format und den Titel der Quelle. Es wird nicht mehr als PDF/UA-1 markiert, es sei denn, die Quelle war es, und eine unbenannte Quelle erhält nicht mehr den Titel „Tagged PDF“.
  • .NET Framework‑Projekte: Bild‑Zusammenführungen in packages.config‑Projekten laden System.ValueTuple nicht mehr fehl, und Zusammenführungen mit SVG‑Dokumenten laden netstandard auf .NET Framework 4.6.2 bis 4.7.0 Laufzeiten nicht mehr fehl.
  • Gepatchte Abhängigkeit: Die Pakete hängen von System.Security.Cryptography.Pkcs 8.0.2 (.NET 6.0 und .NET 8.0) oder 9.0.21 (.NET 10.0) ab, den Versionen, die CVE-2026-84008 und CVE-2026-70162 beheben.
  • LowCode‑Produkte: Ein als einfacher Dateiname angegebener Ausgabepfad wird im aktuellen Verzeichnis gespeichert, und JoinPdf, JoinDocx und JoinPptx lehnen ein zusammengeführtes Dokument eines anderen Formats ab, bevor irgendeine Ausgabe geschrieben wird.

Code‑Beispiel

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
        }
    }
}

Wie Sie das Update erhalten

NuGet

Aktualisieren Sie das neueste GroupDocs.Merger‑Paket über NuGet: GroupDocs.Merger 26.10.0

dotnet add package GroupDocs.Merger --version 26.10.0

Direkter Download

Laden Sie die Assemblies von der Seite GroupDocs.Merger for .NET 26.10 herunter.

Ressourcen