Ми раді оголосити про випуск GroupDocs.Conversion for .NET v26.9, доступний з вересня 2026 р.. У цьому випуску додано підтримку нових форматів GIS та стиснення, реалізовано перетворення презентацій у самодостатні HTML‑слайдшоу, покращено обробку багатосторінкових TIFF‑файлів та введено обмеження у 10 конверсій у режимі оцінки на один процес. Також видалено застарілі члени API та посилено перевірку конфліктних параметрів.

Що нового у цьому випуску

  • [Feature] Додано WIM як джерело конверсії для файлів стиснення (CONVERSIONNET-8488)
  • [Feature] Додано Apple Archive (AAR) як джерело та ціль конверсії для файлів стиснення (CONVERSIONNET-8491)
  • [Feature] Додано ALZ як джерело конверсії для файлів стиснення (CONVERSIONNET-8494)
  • [Feature] Додано GeoJSON Text Sequence як джерело конверсії для GIS‑документів (CONVERSIONNET-8508)
  • [Feature] Додано KMZ як джерело конверсії для GIS‑документів (CONVERSIONNET-8510)
  • [Feature] Додано підтримку конверсії GIS у цільову платформу net462 (CONVERSIONNET-8511)
  • [Feature] Додано GML та OSM XML як цілі конверсії для GIS‑документів (CONVERSIONNET-8512)
  • [Feature] Перетворення презентації у самодостатнє HTML‑слайдшоу (CONVERSIONNET-8529)
  • [Improvement] При конвертації багатосторінкового TIFF у PDF застосовуються розмір і роздільна здатність кожного кадру (CONVERSIONNET-8519)
  • [Improvement] При конвертації багатосторінкового TIFF кадр за кадром застосовуються його розмір і роздільна здатність (CONVERSIONNET-8520)
  • [Improvement] При конвертації багатосторінкового TIFF у тегований PDF застосовуються розмір і роздільна здатність кожного кадру (CONVERSIONNET-8521)
  • [Improvement] Обмеження режиму оцінки до 10 конверсій на процес (CONVERSIONNET-8523)
  • [Improvement] Видалено застарілий слухач конвертера, етапи fluent‑обробника та властивості розміру сторінки (CONVERSIONNET-8561)
  • [Bug] PPTX → PDF: подвійне підкреслення та подвійне перекреслення генерують координати NaN у Linux (CONVERSIONNET-8388)
  • [Bug] Конвертація PDF з більш ніж 4‑ма сторінками завершується помилкою у режимі оцінки (CONVERSIONNET-8515)
  • [Bug] Обмеження на кількість пробних сторінок не застосовується при конвертації PDF у Web (CONVERSIONNET-8516)
  • [Bug] Повернення правильного числа сторінок для багатосторінкового TIFF (CONVERSIONNET-8522)

Публічні зміни API

Змінювальні (Breaking) зміни

Члени, позначені як застарілі у попередніх версіях, видалено:

Видалено Замінник
IConverterListener та ConverterSettings.Listener ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted
ConverterSettings.OnConversionFailed ConversionEvents.OnDocumentFailed
ConverterSettings.OnConversionByPageFailed ConversionEvents.OnPageFailed
ConverterSettings.OnCompressionCompleted ConversionEvents.OnCompressionCompleted
Fluent .OnCompressionCompleted(...) після .Compress(...) (IConversionCompressResultCompleted) FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...)
Fluent‑інтерфейси IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted IConversionHandlersStage
Fluent‑інтерфейси IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted IConversionByPageHandlersStage
CadConvertOptions.PageSize / PageWidth / PageHeight CadConvertOptions.SizeSettings (PageSizeOptions)
EBookConvertOptions.PageSize / PageWidth / PageHeight EBookConvertOptions.SizeSettings (PageSizeOptions)

У fluent‑API метод WithOptions(...) тепер повертає IConversionHandlersStage (або IConversionByPageHandlersStage для конвертації сторінка‑за‑сторінкою). Ланцюжки викликів типу .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() компілюються без змін.

Розмір сторінки тепер задається лише через SizeSettings:

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

Обмеження конверсії у режимі оцінки

Без дійсної ліцензії процес може виконати максимум 10 конверсій. Кожен виклик Converter.Convert(...) рахується як одна конверсія — будь‑яке перевантаження, fluent‑API та навіть невдалі виклики. Converter.GetDocumentInfo() та Converter.IsDocumentPasswordProtected() у рахунок не входять. Лічильник прив’язаний до запущеного процесу; перезапуск програми скидає його. Після застосування дійсної ліцензії обмеження зникає.

11‑а конверсія генерує виключення EvaluationLimitReachedException (наслідує GroupDocsConversionException) з повідомленням:

Ви використовуєте GroupDocs.Conversion у режимі оцінки: досягнуто ліміту у 10 документів, конвертованих за один процес. Отримайте безкоштовну 30‑денну тимчасову ліцензію, щоб зняти всі обмеження оцінки: https://purchase.groupdocs.com/temporary-license/

Застосуйте License або ключ Metered перед першою конверсією, щоб зняти обмеження:

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

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

Код, що працює без ліцензії, може обробляти обмеження:

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

Вивід слайдшоу для конвертації презентації у HTML

Нова властивість WebConvertOptions.SlideShow (за замовчуванням false) перетворює презентацію — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP або FODP — у один самодостатній HTML‑файл (Html або Htm), який відтворюється як слайдшоу. Існуючі конверсії залишаються без змін, доки SlideShow не встановлено в true.

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

При SlideShow = true суперечливі параметри викликають InvalidConvertOptionsException ще до початку конверсії:

Параметр Повідомлення
UsePdf = true WebConvertOptions.SlideShow cannot be combined with UsePdf: converting through PDF discards the slideshow.
Format дорівнює MHT або MHTML WebConvertOptions.SlideShow supports only Html and Htm output, not mht. (або mhtml)
Watermark встановлено WebConvertOptions.SlideShow does not support watermarks.
Zoom відмінний від 100 WebConvertOptions.SlideShow does not support Zoom.

Слайдшоу — це один навігаційний документ, тому перегрузки Convert «сторінка за сторінкою» генерують System.NotSupportedException з повідомленням Saving a presentation slideshow page by page is not supported.

Нові типи файлів

Тип Нові члени
CompressionFileType Aar, Alz, Wim
GisFileType GeoJsonSeq, Kmz
Інформація про документ AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — кожен надає доступ до ContentTree архіву

Приклад конвертації ZIP у Apple Archive:

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

Як отримати оновлення

NuGet

Оновіть пакет GroupDocs.Conversion до останньої версії через NuGet: GroupDocs.Conversion 26.9.0

dotnet add package GroupDocs.Conversion --version 26.9.0

Пряме завантаження

Завантажте збірки зі сторінки GroupDocs.Conversion for .NET 26.9

Ресурси