Мы рады объявить о выпуске 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

Ресурсы