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äßigtruein jedem Konstruktor. Solangetrue, wird keine externe Ressource geladen, außer solche, dieWhitelistedResourcesentsprechen oder vom Handler erlaubt werden.WhitelistedResources— absolute URI‑Präfixe von Ressourcen, die geladen werden, währendSkipExternalResourcestrueist, z. B.https://cdn.example.com/assets/oderfile:///C:/assets/. Standardmäßig leer.ExternalResourceHandler— standardmäßignull.
Rückwärtsinkompatible Änderungen:
- Externe Ressourcen werden standardmäßig nicht mehr geladen. Remote‑Ressourcen (
http,https,ftpund 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 SieSkipExternalResourcesauffalsefür Dokumente, denen Sie vertrauen. LoadOptionsist jetztsealed. Eine davon abgeleitete Klasse lässt sich nicht mehr kompilieren. Verwenden SieLoadOptionsdirekt oder implementieren SieILoadOptions; eine benutzerdefinierteILoadOptions‑Implementierung, die nicht auchIResourceLoadingOptionsimplementiert, erhält die Standard‑Richtlinie.- Ein
WhitelistedResources‑Eintrag, der null, leer, keine absolute URI ist, eine Abfrage oder ein Fragment enthält oder%2F,%5Coder%2Eenthält, lässt denMerger‑KonstruktorArgumentExceptionwerfen („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 alsInnerException. - 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
GroupDocsMergerExceptionfehl („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,OleSpreadsheetOptionsundOleWordProcessingOptions, die einen Dateipfad und eine Seitenzahl erhalten, rendern das Bild des eingebetteten Objekts mit verweigerten externen Ressourcen, unabhängig davon, was dieLoadOptionsdes 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,JoinPptxundRemovePagesPdflö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 wirftArgumentNullException.JoinPdf,JoinDocxundJoinPptxwerfenFileTypeNotSupportedException, 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 erzeugtenJoinPdfundJoinDocxgemischte Ausgaben undJoinPptxschlug später mit einer anderen Meldung fehl. Ein null‑ oder leerer Pfad zu einem zusammengeführten Dokument wirftArgumentNullException(„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 vonArgumentException.
5. Abhängigkeiten
- Die Laufzeitpakete hängen von System.Security.Cryptography.Pkcs 8.0.2 (
GroupDocs.Merger.Net60,GroupDocs.Merger.Net80und deren.Windows‑Paketen) oder 9.0.21 (GroupDocs.Merger.Net100undGroupDocs.Merger.Net100.Windows) ab.GroupDocs.Merger.Net60,GroupDocs.Merger.Net60.WindowsundGroupDocs.Merger.LowCodehängen außerdem von System.Formats.Asn1 8.0.2 ab, undGroupDocs.Merger.LowCodevon System.Security.Cryptography.Pkcs 8.0.2.GroupDocs.Merger.Net462bleibt unverändert. - In .NET Framework‑Projekten fügt das
GroupDocs.Merger‑Paket keine Bindungsumleitung für System.ValueTuple zuapp.configoderweb.config(packages.config‑Projekte) mehr hinzu, und seine .NET Framework‑Build‑Ziele setzenDependsOnNETStandardauftrue, 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.
LoadOptionsverfügt über die neuen EigenschaftenSkipExternalResources,WhitelistedResourcesundExternalResourceHandler, 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
NullReferenceExceptionoderIndexOutOfRangeExceptionfehl, und TeX‑Dokumente mitArgumentException, 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
.ncxhat, schlagen nicht mehr mitNullReferenceExceptionfehl. - 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,JoinDocxundJoinPptxlehnen 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.