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.
- konverze vyvolá výjimku
EvaluationLimitReachedException(odvozenou odGroupDocsConversionException) 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