GroupDocs.Conversion for .NET 26.8 – augustus 2026 uitgavehoogtepunten

What’s new in this release

Public API changes

⚠️ Backward Incompatible Changes – De volgende updates wijzigen bestaand openbaar gedrag. Pas uw code aan om runtime‑fouten te voorkomen.

1. LoadOptions.Format geeft nu null terug in plaats van een uitzondering te gooien wanneer het formaat niet is ingesteld

Betrokken klassen: alle 28 getypeerde load‑options (bijv. SpreadsheetLoadOptions, PdfLoadOptions, CadLoadOptions, …)

Wat is veranderd
Het lezen van de eigenschap Format voordat een formaat is toegewezen, leverde eerder een uitzondering op. Nu wordt null geretourneerd, zodat een eenvoudige null‑check volstaat.

Migratie‑voorbeeld

var loadOptions = new SpreadsheetLoadOptions();

if (loadOptions.Format == null)
{
    // Nieuwe code‑pad – voorheen onbereikbaar omdat de getter een uitzondering gooide.
}

Aanbeveling
Vervang elke try/catch rond loadOptions.Format door een null‑check. Vergelijk niet met FileType.Unknown; de juiste test is == null.

2. Exacte‑matchvalidatie voor CadLoadOptions.LayoutNames met gedetailleerde foutmelding

Betrokken klasse: CadLoadOptions

Wat is veranderd
LayoutNames worden nu exact (hoofdletter‑gevoelig) vergeleken met de lay‑out‑namen van de tekening. Als er geen overeenkomsten zijn, faalt de conversie met een InvalidLoadOptionsException die de beschikbare lay‑outs en de foutieve aanvraag opsomt.

Migratie‑voorbeeld

using GroupDocs.Conversion.Exceptions;

try
{
    using var converter = new Converter("drawing.dwg",
        ctx => new CadLoadOptions { LayoutNames = new[] { "layout1" } });
    converter.Convert("out.pdf", new PdfConvertOptions());
}
catch (InvalidLoadOptionsException ex)
{
    // Voorbeeldbericht:
    // "No layout name in CadLoadOptions.LayoutNames matches this drawing, which carries
    //  Model, Layout1, Layout2. Requested: layout1. Names are matched exactly, so a name
    //  that differs only in case is a different name."
    Console.WriteLine(ex.Message);
}

Aanbeveling

• Zorg dat lay‑out‑namen correct gespeld zijn en exact overeenkomen met de hoofdlettergebruik in de bron‑tekening.
• Wanneer alleen een subset van lay‑outs nodig is, geef dan de exacte namen op; niet‑overeenkomende items worden genegeerd, en overeenkomende lay‑outs worden nog steeds gerenderd.

3. Multi‑sheet CAD‑tekeningen produceren nu één output‑eenheid per blad

Betrokken klassen: Converter, PresentationConvertOptions, PdfConvertOptions

Wat is veranderd
Voorheen resulteerde het converteren van een tekening met meerdere papier‑ruimte lay‑outs in één geflattende afbeelding/dia. De conversie maakt nu aparte output‑eenheden (dia’s, pagina’s, enz.) voor elke lay‑out, met een grootte die overeenkomt met de paginainstellingen van die lay‑out. Converter.GetDocumentInfo().PagesCount geeft nu het aantal gegenereerde eenheden weer.

Migratie‑voorbeeld – conversie

using var converter = new Converter("multi-layout.dwg");

// Drie bladen in, drie dia's uit – voorheen één geflattende dia.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

Migratie‑voorbeeld – paginatelling opvragen

using var converter = new Converter("multi-layout.dwg");
int sheets = converter.GetDocumentInfo().PagesCount; // Retourneert 3 voor drie lay‑outs

Aanbeveling

• Pas downstream‑verwerking (bijv. UI‑paginering, bestandsnaamgeving) aan om meerdere output‑bestanden/pagina’s te ondersteunen.
• Voor tekeningen met één blad blijft het gedrag ongewijzigd.
• De uitzondering is CAD → PDF/UA‑1, die nog steeds één getagde pagina rendert.

4. Nieuwe eigenschap CadLoadOptions.LayoutScope om expliciet te bepalen welke ruimtes worden geconverteerd

Betrokken klasse: CadLoadOptions

Wat is veranderd
LayoutScope maakt het mogelijk om te specificeren of Model, Layouts of Both (standaard) geladen moeten worden.

• Wanneer LayoutNames is ingesteld, wordt LayoutScope genegeerd omdat expliciete namen voorrang hebben.
• Het selecteren van een scope die geen bladen oplevert voor een tekening die ten minste één blad bevat, veroorzaakt nu een InvalidLoadOptionsException in plaats van stilzwijgend de standaardruimtes te renderen.

Migratie‑voorbeeld – alleen papier‑ruimte lay‑outs converteren

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

using var converter = new Converter("drawing.dwg",
    ctx => new CadLoadOptions { LayoutScope = CadLayoutScope.Layouts });
converter.Convert("layouts.pdf", new PdfConvertOptions());

Aanbeveling

• Bestaande code die vertrouwt op de impliciete backend‑keuze blijft werken omdat Both de standaard blijft.
• Om de model‑ruimte uit te sluiten of alleen die te includen, stel LayoutScope in op respectievelijk CadLayoutScope.Model of CadLayoutScope.Layouts.
• Als u eerder probeerde lay‑outs te filteren door een lege LayoutNames‑array te geven, vervang dat patroon dan door een passende LayoutScope‑waarde om een duidelijke fout te krijgen wanneer er geen bladen zijn geselecteerd.

New features

Advanced CAD Layout Control: Selecteer specifieke CAD‑lay‑outs, converteer elke lay‑out naar zijn eigen dia, werkblad, pagina, afbeelding of SVG‑gebied, en kies model‑ruimte, papier‑lay‑outs of beide met CadLayoutScope. Dit levert nauwkeurige, per‑lay‑out output en respecteert blad‑specifieke instellingen zoals oriëntatie en paginagrootte.

Expanded Archive Support: XAR‑ en CAB‑formaten zijn nu beschikbaar zowel als bron als doel voor compressiedocumenten, waardoor naadloze conversie van en naar deze archieftypen mogelijk is.

Modern Diagram Interoperability: Mermaid MMD‑bestanden kunnen worden gebruikt als diagram‑bronnen, en Drawio‑bestanden worden ondersteund als conversiedoelen, waardoor eenvoudige integratie van hedendaagse diagramtools in uw conversiepijplijnen ontstaat.

Critical Stability Improvements: Opgeloste conversiefouten voor EML → PDF, DOCX‑vorm‑omtreklijnen, presentatie‑kop‑ en voetteksten en kapotte samenvattings‑links, Linux‑thumbnail‑generatie en DWG‑blad‑oriëntatie‑afhandeling. Deze correcties verhogen de betrouwbaarheid in e‑mail-, kantoor‑, presentatie‑ en CAD‑werkstromen.

Code example

using var converter = new Converter("multi-layout.dwg");

// Drie bladen in, drie dia's uit – voorheen één geflattende dia.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

How to get the update

NuGet

Install-Package GroupDocs.Conversion -Version 26.8

GroupDocs.Conversion 26.8 on NuGet

Direct download

No direct download links are provided in the release notes.

Resources

• SpreadsheetLoadOptions reference
• PdfLoadOptions reference
• CadLoadOptions reference
• Converter class reference
• PresentationConvertOptions reference
• PdfConvertOptions reference