Jsme rádi, že můžeme oznámit vydání GroupDocs.Conversion for .NET v26.9, dostupné od září 2026. Toto vydání přináší podporu nových GIS a kompresních formátů, umožňuje převod prezentací na samostatné HTML prezentace, zlepšuje zpracování vícestránkových TIFF souborů a zavádí limit 10 konverzí v režimu hodnocení na jeden proces. Také odstraňuje zastaralé členy API a zavádí přísnější validaci konfliktních možností.

Co je nového v tomto vydání

  • [Feature] Přidán formát WIM jako zdroj pro kompresní dokumenty (CONVERSIONNET-8488)
  • [Feature] Přidán Apple Archive (AAR) jako zdroj i cíl pro kompresní dokumenty (CONVERSIONNET-8491)
  • [Feature] Přidán formát ALZ jako zdroj pro kompresní dokumenty (CONVERSIONNET-8494)
  • [Feature] Přidán GeoJSON Text Sequence jako zdroj pro GIS dokumenty (CONVERSIONNET-8508)
  • [Feature] Přidán formát KMZ jako zdroj pro GIS dokumenty (CONVERSIONNET-8510)
  • [Feature] Přidána podpora GIS konverze pro cílový framework net462 (CONVERSIONNET-8511)
  • [Feature] Přidány formáty GML a OSM XML jako cíle pro GIS dokumenty (CONVERSIONNET-8512)
  • [Feature] Převod prezentace na samostatnou HTML prezentaci (CONVERSIONNET-8529)
  • [Improvement] Použít velikost a rozlišení každého snímku při převodu vícestránkového TIFF do PDF (CONVERSIONNET-8519)
  • [Improvement] Použít velikost a rozlišení snímku při převodu vícestránkového TIFF stránku po stránce (CONVERSIONNET-8520)
  • [Improvement] Použít velikost a rozlišení každého snímku při převodu vícestránkového TIFF do označeného PDF (CONVERSIONNET-8521)
  • [Improvement] Omezit režim hodnocení na 10 konverzí na proces (CONVERSIONNET-8523)
  • [Improvement] Odstranit zastaralý posluchač konvertoru, fluentní fáze handlerů a vlastnosti velikosti stránky (CONVERSIONNET-8561)
  • [Bug] PPTX → PDF: dvojité podtržení a dvojité přeškrtnutí vrací NaN souřadnice na Linuxu (CONVERSIONNET-8388)
  • [Bug] Převod PDF s více než 4 stránkami selhává v režimu hodnocení (CONVERSIONNET-8515)
  • [Bug] Limit zkušebních stránek není aplikován při převodu PDF na Web (CONVERSIONNET-8516)
  • [Bug] Vrátit správný počet stránek pro vícestránkový TIFF (CONVERSIONNET-8522)

Změny veřejného API

Zlomové změny

Členové, kteří byli v předchozích verzích označeni jako zastaralí, jsou odstraněni:

Odebráno Náhrada
IConverterListener a ConverterSettings.Listener ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted
ConverterSettings.OnConversionFailed ConversionEvents.OnDocumentFailed
ConverterSettings.OnConversionByPageFailed ConversionEvents.OnPageFailed
ConverterSettings.OnCompressionCompleted ConversionEvents.OnCompressionCompleted
Fluent .OnCompressionCompleted(...) po .Compress(...) (IConversionCompressResultCompleted) FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...)
Fluent rozhraní IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted IConversionHandlersStage
Fluent rozhraní IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted IConversionByPageHandlersStage
CadConvertOptions.PageSize / PageWidth / PageHeight CadConvertOptions.SizeSettings (PageSizeOptions)
EBookConvertOptions.PageSize / PageWidth / PageHeight EBookConvertOptions.SizeSettings (PageSizeOptions)

Ve fluent API nyní WithOptions(...) vrací IConversionHandlersStage (nebo IConversionByPageHandlersStage pro převod po stránkách). Řetězené volání jako .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() se stále kompiluje beze změny.

Velikost stránky se nyní nastavuje pouze přes SizeSettings:

var options = new CadConvertOptions
{
    SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};

Limit konverzí v režimu hodnocení

Bez platné licence může proces provést maximálně 10 konverzí. Každé volání Converter.Convert(...) se počítá jako jedna konverze – ať už jde o jakýkoli overload, fluent API nebo volání, která selžou – bez ohledu na to, kolik výstupních souborů vytvoří. Converter.GetDocumentInfo() a Converter.IsDocumentPasswordProtected() se nepočítají. Počet patří běžícímu procesu; po restartu aplikace se limit resetuje. Jakmile je použita platná licence, konverze již nejsou počítány ani omezeny.

  1. konverze vyvolá výjimku EvaluationLimitReachedException (odvozenou od GroupDocsConversionException) s následující zprávou:

Používáte GroupDocs.Conversion v režimu hodnocení: byl dosažen limit 10 dokumentů převedených na proces. Získejte bezplatnou 30‑denní dočasnou licenci a odeberte všechny limity hodnocení: https://purchase.groupdocs.com/temporary-license/

Aplikujte License nebo Metered klíč před první konverzí, aby byl limit odstraněn:

License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");

using (Converter converter = new Converter("sample.docx"))
{
    converter.Convert("converted.pdf", new PdfConvertOptions());
}

Kód běžící bez licence může limit ošetřit:

try
{
    using (Converter converter = new Converter("sample.docx"))
    {
        converter.Convert("converted.pdf", new PdfConvertOptions());
    }
}
catch (EvaluationLimitReachedException ex)
{
    Console.WriteLine(ex.Message);
}

Výstup prezentace jako slideshow při převodu na HTML

Nová vlastnost WebConvertOptions.SlideShow (výchozí false) převádí prezentaci — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP nebo FODP — do jediného samostatného HTML souboru (Html nebo Htm), který se přehrává jako slideshow. Existující konverze zůstávají beze změny, pokud není SlideShow nastaveno na true.

using (Converter converter = new Converter("presentation.pptx"))
{
    WebConvertOptions options = new WebConvertOptions { SlideShow = true };
    converter.Convert("slideshow.html", options);
}

Při SlideShow = true vyvolají protichůdné možnosti výjimku InvalidConvertOptionsException ještě před zahájením konverze:

Možnost Zpráva
UsePdf = true WebConvertOptions.SlideShow cannot be combined with UsePdf: converting through PDF discards the slideshow.
Format je MHT nebo MHTML WebConvertOptions.SlideShow supports only Html and Htm output, not mht. (nebo mhtml)
Watermark je nastaven WebConvertOptions.SlideShow does not support watermarks.
Zoom jiný než 100 WebConvertOptions.SlideShow does not support Zoom.

Slideshow je jeden navigovatelný dokument, takže overloady Convert po stránkách vyvolají System.NotSupportedException s textem Saving a presentation slideshow page by page is not supported.

Nové typy souborů

Typ Noví členové
CompressionFileType Aar, Alz, Wim
GisFileType GeoJsonSeq, Kmz
Informace o dokumentu AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — každá poskytuje ContentTree archivu

Příklad převodu ZIP na Apple Archive:

using (Converter converter = new Converter("assets.zip"))
{
    CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
    converter.Convert("assets.aar", options);
}

Jak získat aktualizaci

NuGet

Aktualizujte na nejnovější balíček GroupDocs.Conversion přes NuGet: GroupDocs.Conversion 26.9.0

dotnet add package GroupDocs.Conversion --version 26.9.0

Přímé stažení

Stáhněte sestavení ze stránky GroupDocs.Conversion for .NET 26.9

Zdroje