GroupDocs.Merger for .NET 26.9 – Highlights der September 2026‑Veröffentlichung

Wir freuen uns, die Veröffentlichung von GroupDocs.Merger für .NET v26.9 bekannt zu geben, verfügbar seit September 2026. Dieses Release führt das zeilenweise Zusammenführen von Tabellenkalkulationen ein, verbessert die TIFF‑Seitenwahl über PageBuilder, erweitert die Behandlung von Vorschaubildgrößen, behebt Parallelitätsprobleme bei Visio‑ und DOC‑Ausgaben und ersetzt mehrere stillschweigende Fehlermodi durch klare Ausnahmen – wodurch die API robuster und vorhersehbarer wird.

Was ist neu in dieser Version

• [Feature] Excel‑Zeilen aus mehreren Dateien in ein einzelnes Blatt zusammenführen (MERGERNET-2198)
• [Feature] Die PageBuilder‑Seitenwahl auf das erste TIFF‑Dokument anwenden (MERGERNET-1372)
• [Improvement] Eine Ausnahme werfen, wenn SetLicense die Lizenzdatei nicht finden kann (MERGERNET-2183)
• [Improvement] Einen leeren Lizenz‑Stream in SetLicense ablehnen (MERGERNET-2184)
• [Improvement] Eine klare Ausnahme werfen, wenn ein Bild‑ oder Audiodatei in ein nicht unterstütztes Format eingefügt wird (MERGERNET-2190)
• [Improvement] System.Drawing.Common aus den plattformübergreifenden Paketen entfernen und fehlende Abhängigkeiten deutlich melden (MERGERNET-2202)
• [Bug] Die Quelldatei schließen, nachdem Merger ein Dokument per Pfad öffnet oder zusammenführt (MERGERNET-2187)
• [Bug] Die Stream‑Factory nur einmal aufrufen, wenn Merger konstruiert wird (MERGERNET-2189)
• [Bug] Beschädigte DOC‑Ausgabe beheben, wenn PDF‑ oder XPS‑Dokumente aus mehreren Threads in DOC zusammengeführt werden (MERGERNET-2192)
• [Bug] Eine Seitenorientierungsänderung auf jede Seite anwenden, wenn keine Seitenzahlen angegeben sind (MERGERNET-2194)
• [Bug] Die angeforderte Vorschau‑Breite und -Höhe in jeder Dokumentformat‑Familie berücksichtigen (MERGERNET-2196)
• [Bug] ExtractPages und RemovePages mit fehlenden Seitenzahlen ablehnen, anstatt stillschweigend ein leeres oder unverändertes Dokument zu erzeugen (MERGERNET-2197)
• [Bug] Visio‑Dokumente, die gleichzeitig verarbeitet werden, intermittierend mit ArgumentNullException wegen trueTypeFont fehlschlagen lassen (MERGERNET-2199)
• [Bug] PDF‑Portfolios, die fehlschlagen, wenn eine eingebettete Datei kein Änderungsdatum hat, mit NullReferenceException beheben (MERGERNET-2200)

Öffentliche API-Änderungen

1. Tabellenkalkulationen zusammenführen — zeilenweise Modus (neue API)

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

• SkipRows überspringt die ersten N Zeilen jeder zusammengeführten Datei, z. B. eine Kopfzeile. Das erste Dokument wird immer vollständig übernommen. SkipRows und SheetMatching haben im Modus Worksheets keine Wirkung.
• Unterstützte Formate: XLSX, XLS, XLSM, XLSB, XLTX, XLTM, XLT, XLAM und ODS.
• Übernommen werden: Zellwerte, Formeln (relative Bezüge angepasst), Stile, zusammengeführte Zellen und Zeilenhöhen. Nicht übernommen werden: Diagramme, Bilder, Pivot‑Tabellen, Tabellen, bedingte Formatierung und Datenvalidierung.
• Ein negativer SkipRows löst GroupDocsMergerException aus („The count of rows to skip can not be negative.“).
• Überschreitung der Zeilenlimits (65 536 für XLS/XLT, 1 048 576 für andere) löst GroupDocsMergerException aus.
• ApplyPageBuilder wirft GroupDocsMergerException, solange eine Tabellenkalkulation im Modus Rows noch aussteht.

2. TIFF — PageBuilder wendet die Seitenwahl des ersten Dokuments an

Keine API‑Änderung. CreatePageBuilder und ApplyPageBuilder wenden nun die aus dem ersten TIFF‑Dokument ausgewählten Seiten an; zuvor wurden immer alle Seiten des ersten Dokuments einbezogen. Zusammenführungen, die PageBuilder nicht nutzen, erzeugen das gleiche Ergebnis wie zuvor.

Nach einer Zusammenführung mit ImageJoinOptions werfen CreatePageBuilder und ApplyPageBuilder nun GroupDocsMergerException, weil zusammengeführte Bilder zu einem Layout statt zu einer Seitenfolge zusammengesetzt werden.

3. Lizenzierung — SetLicense schlägt nicht mehr stillschweigend fehl

• License.SetLicense(string licensePath) wirft InvalidOperationException („License not found: …“), wenn die Lizenzdatei nicht gefunden werden kann.
• License.SetLicense(Stream licenseStream) wirft ArgumentNullException bei einem leeren Stream.

4. Seitenoperationen mit leerer Seitenliste

• ExtractPages und RemovePages, die ohne Seitenzahlen aufgerufen werden, werfen jetzt GroupDocsMergerException („There are no page numbers to extract.“ / „There are no page numbers to remove.“).
• ChangeOrientation, das ohne Seitenzahlen aufgerufen wird, ändert die Orientierung jeder Seite für PDF, XPS, Textverarbeitungs‑, Tabellen‑ und Visio‑Dokumente.

5. Vorschaugröße

GeneratePreview skaliert nun jedes Seitenbild auf die angeforderte Width und Height – bei Angabe beider Werte wird exakt auf diese Größe gestreckt. Ein negativer Width oder Height löst jetzt GroupDocsMergerException aus.

6. System.Drawing.Common und fehlende Abhängigkeiten

• Die plattformübergreifenden Pakete (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80, GroupDocs.Merger.Net100) hängen nicht mehr von System.Drawing.Common ab.
• Fehlende Laufzeit‑Abhängigkeiten werfen nun MissingDependencyException und geben die fehlende Komponente sowie Installationshinweise an.

7. Zusammenführen von Bildern und Audiodateien in nicht unterstützte Formate

Das Zusammenführen einer Bild‑ oder Audiodatei in ein nicht unterstütztes Dokumentformat löst FileTypeNotSupportedException aus („Joining ‘…’ into ‘…’ is not supported“).

Neue Funktionen

• Zeilenweises Zusammenführen von Tabellenkalkulationen: Zeilen mehrerer Tabellen können jetzt in ein einzelnes Blatt angehängt werden, anstatt als separate Arbeitsblätter hinzugefügt zu werden, mit Optionen zum Überspringen von Kopfzeilen und zum Abgleichen von Blättern nach Position.
• PageBuilder für TIFF‑Dokumente: Eine mit PageBuilder getroffene Seitenwahl wird nun auch auf das erste TIFF‑Dokument angewendet – zuvor wurden immer alle Seiten dieses Dokuments einbezogen.
• Exakte Vorschau‑Abmessungen: GeneratePreview liefert nun Bilder in der angeforderten Width und Height für jede Dokumentformat‑Familie.
• Parallelitätskorrekturen: Visio‑ und DOC‑Ausgaben schlagen nicht mehr intermittierend fehl, wenn sie aus mehreren Threads verarbeitet werden.
• Ressourcen‑Handling: Dokumente, die per Dateipfad geöffnet oder zusammengeführt werden, halten die Quelldatei nicht mehr offen; Stream‑Factories werden exakt einmal aufgerufen.
• Klarere Fehlermeldungen: Mehrere Vorgänge, die zuvor stillschweigend fehlgeschlagen sind, werfen jetzt beschreibende Ausnahmen.

Code‑Beispiel

using GroupDocs.Merger;
using GroupDocs.Merger.Domain.Options;

using (var merger = new Merger("january.xlsx"))
{
    var options = new SpreadsheetJoinOptions
    {
        Mode = SpreadsheetJoinMode.Rows,   // Zeilen in die bestehenden Blätter anhängen
        SkipRows = 1                        // Kopfzeile jeder zusammengeführten Datei überspringen
    };

    merger.Join("february.xlsx", options);
    merger.Join("march.xlsx", options);
    merger.Save("q1.xlsx");
}

Wie Sie das Update erhalten

NuGet

• Paket: GroupDocs.Merger 26.9.0
• Installationsbefehl:

  dotnet add package GroupDocs.Merger --version 26.9.0
  

Direkter Download

• GroupDocs.Merger für .NET 26.9

Ressourcen

• Vollständige Release‑Notes
• Dokumentation
• Free Support Forum