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

Zasoby