Z przyjemnością ogłaszamy wydanie GroupDocs.Conversion for .NET v26.9, dostępne od września 2026. To wydanie wprowadza obsługę nowych formatów GIS i kompresji, umożliwia konwersję prezentacji do samodzielnych pokazów slajdów HTML, usprawnia obsługę wielostronicowych plików TIFF oraz wprowadza limit 10 konwersji w trybie ewaluacyjnym na proces. Usuwa także przestarzałe elementy API i wprowadza bardziej rygorystyczną walidację konfliktujących opcji.
Co nowego w tym wydaniu
- [Feature] Dodaj WIM jako źródło konwersji dla dokumentów kompresji (CONVERSIONNET-8488)
- [Feature] Dodaj Apple Archive (AAR) jako źródło i cel konwersji dla dokumentów kompresji (CONVERSIONNET-8491)
- [Feature] Dodaj ALZ jako źródło konwersji dla dokumentów kompresji (CONVERSIONNET-8494)
- [Feature] Dodaj GeoJSON Text Sequence jako źródło konwersji dla dokumentów GIS (CONVERSIONNET-8508)
- [Feature] Dodaj KMZ jako źródło konwersji dla dokumentów GIS (CONVERSIONNET-8510)
- [Feature] Dodaj obsługę konwersji GIS do docelowego frameworku net462 (CONVERSIONNET-8511)
- [Feature] Dodaj GML i OSM XML jako cele konwersji dla dokumentów GIS (CONVERSIONNET-8512)
- [Feature] Konwertuj prezentację do samodzielnego pokazu slajdów HTML (CONVERSIONNET-8529)
- [Improvement] Zastosuj rozmiar i rozdzielczość każdej klatki przy konwersji wielostronicowego TIFF do PDF (CONVERSIONNET-8519)
- [Improvement] Zastosuj rozmiar i rozdzielczość klatki przy konwersji wielostronicowego TIFF strona po stronie (CONVERSIONNET-8520)
- [Improvement] Zastosuj rozmiar i rozdzielczość każdej klatki przy konwersji wielostronicowego TIFF do oznaczonego PDF (CONVERSIONNET-8521)
- [Improvement] Ogranicz tryb ewaluacyjny do 10 konwersji na proces (CONVERSIONNET-8523)
- [Improvement] Usuń przestarzały nasłuchiwacz konwertera, etapy obsługi fluent oraz właściwości rozmiaru strony (CONVERSIONNET-8561)
- [Bug] PPTX do PDF: podwójne podkreślenie i podwójne przekreślenie generują współrzędne NaN w systemie Linux (CONVERSIONNET-8388)
- [Bug] Konwersja PDF z więcej niż 4 stronami nie powodzi się w trybie ewaluacyjnym (CONVERSIONNET-8515)
- [Bug] Limit stron próbnych nie jest stosowany przy konwersji PDF do Web (CONVERSIONNET-8516)
- [Bug] Zwracaj prawidłową liczbę stron dla wielostronicowego TIFF (CONVERSIONNET-8522)
Zmiany w publicznym API
Zmiany łamiące kompatybilność
Członkowie oznaczeni jako przestarzali w poprzednich wersjach zostali usunięci:
| Usunięto | Zastąpiono |
|---|---|
IConverterListener i 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 interfaces IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted |
IConversionHandlersStage |
Fluent interfaces IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted |
IConversionByPageHandlersStage |
CadConvertOptions.PageSize / PageWidth / PageHeight |
CadConvertOptions.SizeSettings (PageSizeOptions) |
EBookConvertOptions.PageSize / PageWidth / PageHeight |
EBookConvertOptions.SizeSettings (PageSizeOptions) |
W fluent API, WithOptions(...) teraz zwraca IConversionHandlersStage (lub IConversionByPageHandlersStage dla konwersji strona po stronie). Łańcuchowe wywołania takie jak .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() kompilują się bez zmian.
Rozmiar strony jest teraz ustawiany wyłącznie poprzez SizeSettings:
var options = new CadConvertOptions
{
SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};
Limit konwersji w trybie ewaluacyjnym
Bez ważnej licencji proces może wykonać maksymalnie 10 konwersji. Każde wywołanie Converter.Convert(...) liczy się jako jedna konwersja — każdy overload, fluent API oraz wywołania, które zakończą się niepowodzeniem — niezależnie od liczby wygenerowanych plików wyjściowych. Converter.GetDocumentInfo() i Converter.IsDocumentPasswordProtected() nie są liczone. Licznik jest powiązany z bieżącym procesem; ponowne uruchomienie aplikacji resetuje licznik. Po zastosowaniu ważnej licencji konwersje nie są już liczone ani ograniczane.
11‑ta konwersja rzuca wyjątek EvaluationLimitReachedException (dziedziczący po GroupDocsConversionException) z komunikatem:
Używasz GroupDocs.Conversion w trybie ewaluacyjnym: osiągnięto limit 10 dokumentów konwertowanych na proces. Uzyskaj darmową 30‑dniową tymczasową licencję, aby usunąć wszystkie limity ewaluacyjne: https://purchase.groupdocs.com/temporary-license/
Zastosuj License lub klucz Metered przed pierwszą konwersją, aby usunąć limit:
License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
Kod działający bez licencji może obsłużyć limit:
try
{
using (Converter converter = new Converter("sample.docx"))
{
converter.Convert("converted.pdf", new PdfConvertOptions());
}
}
catch (EvaluationLimitReachedException ex)
{
Console.WriteLine(ex.Message);
}
Wyjście pokazu slajdów przy konwersji prezentacji do HTML
Nowa właściwość WebConvertOptions.SlideShow (domyślnie false) konwertuje prezentację — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP lub FODP — do jednego samodzielnego pliku HTML (Html lub Htm), który odtwarza się jako pokaz slajdów. Istniejące konwersje pozostają niezmienione, chyba że SlideShow zostanie ustawione na true.
using (Converter converter = new Converter("presentation.pptx"))
{
WebConvertOptions options = new WebConvertOptions { SlideShow = true };
converter.Convert("slideshow.html", options);
}
Przy SlideShow = true sprzeczne opcje powodują wyrzucenie InvalidConvertOptionsException przed rozpoczęciem konwersji:
| Opcja | Komunikat |
|---|---|
UsePdf = true |
WebConvertOptions.SlideShow nie może być łączone z UsePdf: konwersja przez PDF usuwa pokaz slajdów. |
Format jest MHT lub MHTML |
WebConvertOptions.SlideShow obsługuje tylko wyjście Html i Htm, nie mht. (lub mhtml) |
Watermark jest ustawiony |
WebConvertOptions.SlideShow nie obsługuje znaków wodnych. |
Zoom inny niż 100 |
WebConvertOptions.SlideShow nie obsługuje Zoom. |
Pokaz slajdów jest jednym nawigowalnym dokumentem, więc przeciążenia Convert działające strona po stronie rzucają System.NotSupportedException z komunikatem Saving a presentation slideshow page by page is not supported (zachowano oryginalny komunikat, ponieważ jest to treść wyjątku).
Nowe typy plików
| Typ | Nowi członkowie |
|---|---|
CompressionFileType |
Aar, Alz, Wim |
GisFileType |
GeoJsonSeq, Kmz |
| Informacje o dokumencie | AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — każdy udostępnia drzewo zawartości archiwum (ContentTree) |
Przykład konwersji ZIP do Apple Archive:
using (Converter converter = new Converter("assets.zip"))
{
CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
converter.Convert("assets.aar", options);
}
Jak uzyskać aktualizację
NuGet
Uaktualnij do najnowszego pakietu GroupDocs.Conversion za pośrednictwem NuGet: GroupDocs.Conversion 26.9.0
dotnet add package GroupDocs.Conversion --version 26.9.0
Bezpośrednie pobranie
Pobierz zestawy z strony GroupDocs.Conversion for .NET 26.9