We zijn blij de release van GroupDocs.Merger for .NET v26.9 aan te kondigen, beschikbaar vanaf september 2026. Deze release introduceert het rijgewijs samenvoegen van spreadsheets, verbetert de TIFF‑paginaselectie via PageBuilder, verbetert de afhandeling van preview‑afmetingen, lost concurrency‑problemen op met Visio‑ en DOC‑uitvoer, en vervangt verschillende stille foutmodi door duidelijke uitzonderingen—waardoor de API robuuster en voorspelbaarder wordt.

Wat is nieuw in deze release

  • [Feature] Excel‑rijen van meerdere bestanden samenvoegen tot één blad (MERGERNET-2198)
  • [Feature] De paginaselectie van PageBuilder toepassen op het eerste TIFF‑document (MERGERNET-1372)
  • [Improvement] Een uitzondering gooien wanneer SetLicense het licentiebestand niet kan vinden (MERGERNET-2183)
  • [Improvement] Een lege licentiestroom afwijzen in SetLicense (MERGERNET-2184)
  • [Improvement] Een duidelijke uitzondering gooien bij het samenvoegen van een afbeelding of audiobestand naar een niet‑ondersteund formaat (MERGERNET-2190)
  • [Improvement] System.Drawing.Common verwijderen uit de cross‑platform pakketten en ontbrekende afhankelijkheden duidelijk rapporteren (MERGERNET-2202)
  • [Bug] Het bronbestand sluiten nadat Merger een document opent of samenvoegt via pad (MERGERNET-2187)
  • [Bug] De stream‑factory slechts één keer aanroepen bij het construeren van Merger (MERGERNET-2189)
  • [Bug] Corrigeer corrupte DOC‑uitvoer bij het samenvoegen van PDF‑ of XPS‑documenten naar DOC vanuit meerdere threads (MERGERNET-2192)
  • [Bug] Een paginavoorlichtingswijziging toepassen op elke pagina wanneer er geen paginanummers zijn opgegeven (MERGERNET-2194)
  • [Bug] De gevraagde preview‑Breedte en -Hoogte respecteren in elke documentformaatfamilie (MERGERNET-2196)
  • [Bug] ExtractPages en RemovePages die zonder paginanummers worden aangeroepen afwijzen in plaats van stilletjes een leeg of ongewijzigd document te produceren (MERGERNET-2197)
  • [Bug] Visio‑documenten die intermitterend falen met ArgumentNullException trueTypeFont bij gelijktijdige verwerking corrigeren (MERGERNET-2199)
  • [Bug] PDF‑portefeuilles die falen met NullReferenceException wanneer een ingebed bestand geen wijzigingsdatum heeft corrigeren (MERGERNET-2200)

Wijzigingen in de openbare API

1. Spreadsheet‑samenvoeging — rij‑gewijze modus (nieuwe API)

Nieuwe openbare types in de GroupDocs.Merger.Domain.Options namespace:

Type Description
SpreadsheetJoinOptions Samenvoegopties voor spreadsheets, afgeleid van PageJoinOptions. Eigenschappen: Mode, SkipRows, SheetMatching.
SpreadsheetJoinMode Worksheets (standaard) voegt de bladen van het samengevoegde bestand toe als afzonderlijke werkbladen, zoals voorheen. Rows voegt de rijen van elk samengevoegd bestand toe onder de laatste rij met gegevens van het overeenkomende blad van het resultaat.
SpreadsheetSheetMatching ByIndex (standaard) voegt blad 2 toe aan blad 2, blad 3 aan blad 3, enz.; FirstSheetOnly voegt alleen het eerste blad van elk samengevoegd bestand toe.
  • SkipRows slaat de eerste N rijen van elk samengevoegd bestand over, bijvoorbeeld een koprij. Het eerste document wordt altijd volledig genomen. SkipRows en SheetMatching hebben geen effect in de Worksheets‑modus.
  • Ondersteunde formaten: XLSX, XLS, XLSM, XLSB, XLTX, XLTM, XLT, XLAM en ODS.
  • Overgenomen: celwaarden, formules (relatieve verwijzingen aangepast), stijlen, samengevoegde cellen en rijhoogtes. Niet overgenomen: grafieken, afbeeldingen, draaitabellen, tabellen, voorwaardelijke opmaak en gegevensvalidatie.
  • Een negatieve SkipRows gooit een GroupDocsMergerException (“The count of rows to skip can not be negative.”).
  • Het overschrijden van rijlimieten (65.536 voor XLS/XLT, 1.048.576 voor andere) gooit een GroupDocsMergerException.
  • ApplyPageBuilder gooit een GroupDocsMergerException terwijl een spreadsheet die in Rows‑modus is samengevoegd in behandeling is.

2. TIFF — PageBuilder past de paginaselectie van het eerste document toe

Geen API‑wijziging. CreatePageBuilder en ApplyPageBuilder passen nu de pagina’s toe die zijn geselecteerd uit het eerste TIFF‑document; voorheen werden altijd alle pagina’s van het eerste document opgenomen. Samenvoegingen die geen PageBuilder gebruiken leveren hetzelfde resultaat op als voorheen.

Na een samenvoeging met ImageJoinOptions gooien CreatePageBuilder en ApplyPageBuilder nu een GroupDocsMergerException, omdat samengevoegde afbeeldingen worden samengesteld tot één lay-out in plaats van een paginasequentie.

3. Licenties — SetLicense faalt niet langer stilletjes

  • License.SetLicense(string licensePath) gooit een InvalidOperationException (“License not found: …”) wanneer het licentiebestand niet kan worden gevonden.
  • License.SetLicense(Stream licenseStream) gooit een ArgumentNullException voor een lege stream.

4. Pagina‑operaties met een lege paginalijst

  • ExtractPages en RemovePages die zonder paginanummers worden aangeroepen, gooien nu een GroupDocsMergerException (“There are no page numbers to extract.” / “There are no page numbers to remove.”).
  • ChangeOrientation die zonder paginanummers wordt aangeroepen, wijzigt nu de oriëntatie van elke pagina voor PDF-, XPS-, tekstverwerkings-, spreadsheet‑ en Visio‑documenten.

5. Preview‑grootte

GeneratePreview schaalt nu elke paginabeeld naar de gevraagde Width en Height — uitgerekt tot exact die grootte wanneer beide zijn opgegeven. Een negatieve Width of Height gooit nu een GroupDocsMergerException.

6. System.Drawing.Common en ontbrekende afhankelijkheden

  • Cross‑platform pakketten (GroupDocs.Merger.Net60, GroupDocs.Merger.Net80, GroupDocs.Merger.Net100) zijn niet langer afhankelijk van System.Drawing.Common.
  • Ontbrekende runtime‑afhankelijkheden gooien nu een MissingDependencyException, waarin het ontbrekende component en installatie‑instructies worden genoemd.

7. Afbeeldingen en audio samenvoegen naar niet‑ondersteunde formaten

Het samenvoegen van een afbeelding of audiobestand naar een niet‑ondersteund documentformaat gooit nu een FileTypeNotSupportedException (“Joining ‘…’ into ‘…’ is not supported”).

Nieuwe functies

  • Rij‑gewijze spreadsheet‑samenvoeging: Rijen van meerdere spreadsheets kunnen nu worden toegevoegd aan één blad in plaats van als afzonderlijke werkbladen, met opties om koprijen over te slaan en bladen op positie te matchen.
  • PageBuilder voor TIFF‑documenten: Een paginaselectie gemaakt met PageBuilder wordt nu ook toegepast op het eerste TIFF‑document — voorheen werden altijd alle pagina’s ervan opgenomen.
  • Nauwkeurige preview‑afmetingen: GeneratePreview retourneert nu afbeeldingen met de gevraagde Width en Height voor elke documentformaatfamilie.
  • Concurrency‑oplossingen: Visio‑ en DOC‑uitvoer falen niet langer intermitterend bij verwerking vanuit meerdere threads.
  • Resource‑beheer: Documenten die via bestandspad worden geopend of samengevoegd houden het bronbestand niet meer open; stream‑factories worden precies één keer aangeroepen.
  • Duidelijkere fouten: Diverse bewerkingen die voorheen stilletjes faalden, gooien nu beschrijvende uitzonderingen.

Code‑voorbeeld

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

using (var merger = new Merger("january.xlsx"))
{
    var options = new SpreadsheetJoinOptions
    {
        Mode = SpreadsheetJoinMode.Rows,   // append rows into the existing sheets
        SkipRows = 1                        // skip the header row of each joined file
    };

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

Hoe de update te verkrijgen

NuGet

Directe download

Bronnen