Мы рады объявить о выпуске 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
Разрушающие изменения
Члены, помеченные как устаревшие в предыдущих версиях, удалены:
| Удалено | Замена |
|---|---|
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