GroupDocs.Conversion for .NET 26.8 – Hlavní body vydání srpen 2026

There are 18 features, improvements, and bug fixes in this release. This update reinforces CAD conversion with layout‑level selection, per‑layout output (slides, worksheets, pages, SVG, etc.), and adds XAR and CAB as compression targets, as well as Mermaid MMD and Drawio as diagram sources/targets.

Co je nového v tomto vydání

Změny veřejného API

⚠️ Zpětně nekompatibilní změny – Následující aktualizace mění stávající veřejné chování. Upravte svůj kód, aby nedocházelo k chybám za běhu.

1. LoadOptions.Format nyní vrací null místo vyhození výjimky, když není formát nastaven

Ovlivněné třídy: všechny 28 typizovaných load‑options (např., SpreadsheetLoadOptions, PdfLoadOptions, CadLoadOptions, …)

Co se změnilo
Čtení vlastnosti Format před přiřazením formátu dříve vyvolávalo výjimku. Nyní vrací null, což umožňuje jednoduchou kontrolu na null.

Příklad migrace

var loadOptions = new SpreadsheetLoadOptions();

if (loadOptions.Format == null)
{
    // Nová cesta kódu – dříve nedosažitelná, protože getter vyhazoval výjimku.
}

Pokyny
Nahraďte jakýkoli try/catch kolem loadOptions.Format kontrolou na null. Nekontrolujte proti FileType.Unknown; správný test je == null.

2. Přesná validace CadLoadOptions.LayoutNames s podrobným hlášením chyb

Ovlivněná třída: CadLoadOptions

Co se změnilo
LayoutNames jsou nyní porovnávány přesně (rozlišuje se velikost písmen) s názvy rozvržení v kresbě. Pokud žádný neodpovídá, konverze selže s InvalidLoadOptionsException, která vypíše dostupná rozvržení a neodpovídající požadavek.

Příklad migrace

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)
{
    // Příklad zprávy:
    // "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);
}

Pokyny

• Ujistěte se, že názvy rozvržení jsou napsány správně a odpovídají velikosti písmen použité v zdrojové kresbě.
• Pokud potřebujete jen podmnožinu rozvržení, uveďte přesné názvy; neodpovídající položky jsou ignorovány a odpovídající rozvržení jsou stále vykreslena.

3. CAD výkresy s více listy nyní vytvářejí jednu výstupní jednotku na list

Ovlivněné třídy: Converter, PresentationConvertOptions, PdfConvertOptions

Co se změnilo
Dříve převod kresby s více papírovými rozvrženími vedl k jednomu zploštělému obrázku/snímku. Nyní konverze vytváří samostatné výstupní jednotky (snímky, stránky atd.) pro každé rozvržení, velikost odvozenou z nastavení stránky rozvržení. Converter.GetDocumentInfo().PagesCount nyní vrací počet vytvořených jednotek.

Příklad migrace – převod

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

// Tři listy dovnitř, tři snímky ven – dříve jeden zploštělý snímek.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

Příklad migrace – dotaz na počet stránek

using var converter = new Converter("multi-layout.dwg");
int sheets = converter.GetDocumentInfo().PagesCount; // Vrátí 3 pro tři rozvržení

Pokyny

• Přizpůsobte následné zpracování (např. stránkování UI, pojmenování souborů) tak, aby zvládalo více výstupních souborů/stránek.
• Pro výkresy s jedním listem se chování nemění.
• Výjimkou je CAD → PDF/UA‑1, který stále vykresluje jedinou označenou stránku.

4. Nová vlastnost CadLoadOptions.LayoutScope pro explicitní řízení, které prostory jsou konvertovány

Ovlivněná třída: CadLoadOptions

Co se změnilo
LayoutScope umožňuje určit, zda načíst Model, Layouts nebo Both (výchozí).

• Když je nastaven LayoutNames, LayoutScope se ignoruje, protože explicitní názvy mají přednost.
• Výběr rozsahu, který nevrátí žádné listy u kresby, která alespoň jeden list obsahuje, nyní vyvolá InvalidLoadOptionsException místo tichého načtení výchozích prostorů.

Příklad migrace – převod jen papírových rozvržení

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());

Pokyny

• Stávající kód, který se spoléhal na implicitní volbu backendu, bude i nadále fungovat, protože Both zůstává výchozím nastavením.
• Pro vyloučení modelového prostoru nebo jeho zahrnutí použijte CadLayoutScope.Model nebo CadLayoutScope.Layouts.
• Pokud jste dříve filtrovali rozvržení prázdným polem LayoutNames, nahraďte tento vzor vhodnou hodnotou LayoutScope, aby při výběru bez listů došlo k jasné chybě.

Nové funkce

Pokročilá kontrola CAD rozvržení: Vyberte konkrétní CAD rozvržení, převádějte každé rozvržení na vlastní snímek, list, stránku, obrázek nebo SVG oblast a pomocí CadLayoutScope určete modelový prostor, papírová rozvržení nebo obojí. To poskytuje přesný výstup na úrovni rozvržení a respektuje nastavení specifické pro list, jako je orientace a velikost stránky.

Rozšířená podpora archivů: Formáty XAR a CAB jsou nyní k dispozici jak jako zdroj, tak jako cíl pro kompresní dokumenty, což umožňuje bezproblémovou konverzi tam a zpět.

Moderní interoperabilita diagramů: Soubory Mermaid MMD mohou být použity jako zdroje diagramů a soubory Drawio jsou podporovány jako cíle konverze, což usnadňuje integraci současných nástrojů pro tvorbu diagramů do vašich konverzních pipeline.

Kritická vylepšení stability: Opraveny selhání konverze EML → PDF, nesprávné vykreslování obrysů tvarů DOCX, hlavičky/patičky v prezentacích, poškozené souhrnné odkazy, generování náhledů v Linuxu a zpracování orientace listů DWG. Tyto opravy zvyšují spolehlivost napříč e‑mailem, kancelářskými aplikacemi, prezentacemi i CAD workflow.

Příklad kódu

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

// Tři listy dovnitř, tři snímky ven – dříve jeden zploštělý snímek.
converter.Convert("drawing.pptx", new PresentationConvertOptions());

Jak získat aktualizaci

NuGet

Install-Package GroupDocs.Conversion -Version 26.8

GroupDocs.Conversion 26.8 na NuGet

Přímé stažení

V poznámkách k vydání nejsou uvedeny žádné přímé odkazy ke stažení.

Zdroje

• Reference SpreadsheetLoadOptions
• Reference PdfLoadOptions
• Reference CadLoadOptions
• Reference třídy Converter
• Reference PresentationConvertOptions
• Reference PdfConvertOptions