Ми раді оголосити про випуск 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