我们很高兴宣布 GroupDocs.Conversion for .NET v26.9 已于 2026年9月 发布。此版本引入了对新的 GIS 和压缩格式的支持,能够将演示文稿转换为自包含的 HTML 幻灯片,改进了多页 TIFF 的处理,并在每个进程中强制执行 10 次转换的评估限制。它还移除了过时的 API 成员,并对冲突选项实施了更严格的验证。

本次发布的新功能

  • 【功能】 将 WIM 添加为压缩文档的转换来源 (CONVERSIONNET-8488)
  • 【功能】 将 Apple Archive (AAR) 添加为压缩文档的转换来源和目标 (CONVERSIONNET-8491)
  • 【功能】 将 ALZ 添加为压缩文档的转换来源 (CONVERSIONNET-8494)
  • 【功能】 将 GeoJSON 文本序列添加为 GIS 文档的转换来源 (CONVERSIONNET-8508)
  • 【功能】 将 KMZ 添加为 GIS 文档的转换来源 (CONVERSIONNET-8510)
  • 【功能】 为 net462 目标框架添加 GIS 转换支持 (CONVERSIONNET-8511)
  • 【功能】 将 GML 和 OSM XML 添加为 GIS 文档的转换目标 (CONVERSIONNET-8512)
  • 【功能】 将演示文稿转换为自包含的 HTML 幻灯片 (CONVERSIONNET-8529)
  • 【改进】 在将多页 TIFF 转换为 PDF 时,使用每帧自身的页面尺寸和分辨率 (CONVERSIONNET-8519)
  • 【改进】 在逐页转换多页 TIFF 时,使用帧自身的页面尺寸和分辨率 (CONVERSIONNET-8520)
  • 【改进】 在将多页 TIFF 转换为带标签的 PDF 时,使用每帧自身的页面尺寸和分辨率 (CONVERSIONNET-8521)
  • 【改进】 将评估模式限制为每个进程最多 10 次转换 (CONVERSIONNET-8523)
  • 【改进】 移除过时的转换器监听器、流式处理阶段和页面尺寸属性 (CONVERSIONNET-8561)
  • 【错误】 PPTX 转 PDF:在 Linux 上双下划线和双删除线会产生 NaN 坐标 (CONVERSIONNET-8388)
  • 【错误】 在评估模式下转换超过 4 页的 PDF 会失败 (CONVERSIONNET-8515)
  • 【错误】 将 PDF 转换为 Web 时未应用试用页数限制 (CONVERSIONNET-8516)
  • 【错误】 为多页 TIFF 返回正确的页数 (CONVERSIONNET-8522)

公共 API 更改

重大更改

已在早期版本中标记为过时的成员已被移除:

已移除 替代
IConverterListener and ConverterSettings.Listener ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted
ConverterSettings.OnConversionFailed ConversionEvents.OnDocumentFailed
ConverterSettings.OnConversionByPageFailed ConversionEvents.OnPageFailed
ConverterSettings.OnCompressionCompleted ConversionEvents.OnCompressionCompleted
流式 .OnCompressionCompleted(...) 在 .Compress(...) 之后 (IConversionCompressResultCompleted) FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...)
流式接口 IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted IConversionHandlersStage
流式接口 IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted IConversionByPageHandlersStage
CadConvertOptions.PageSize / PageWidth / PageHeight CadConvertOptions.SizeSettings (PageSizeOptions)
EBookConvertOptions.PageSize / PageWidth / PageHeight EBookConvertOptions.SizeSettings (PageSizeOptions)

在流式 API 中,WithOptions(...) 现在返回 IConversionHandlersStage(对于逐页转换则返回 IConversionByPageHandlersStage)。链式调用如 .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() 仍可正常编译。

页面尺寸现在只能通过 SizeSettings 设置:

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

评估模式转换限制

如果没有有效许可证,单个进程最多只能运行 10 次转换。每次调用 Converter.Convert(...) 都计为一次转换——无论是哪个重载、流式 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 不能与 UsePdf 组合使用:通过 PDF 转换会丢失幻灯片。
Format is MHT or MHTML WebConvertOptions.SlideShow 仅支持 Html 和 Htm 输出,不支持 mht(或 mhtml)。
Watermark is set WebConvertOptions.SlideShow 不支持水印。
Zoom other than 100 WebConvertOptions.SlideShow 不支持 Zoom。

幻灯片是一个可导航的文档,因此逐页的 Convert 重载会抛出 System.NotSupportedException,其消息为 不支持逐页保存演示文稿幻灯片。

新文件类型

类型 新成员
CompressionFileType Aar, Alz, Wim
GisFileType GeoJsonSeq, Kmz
文档信息 AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — each exposes the archive’s ContentTree

示例:将 ZIP 转换为 Apple Archive:

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

如何获取更新

NuGet

通过 NuGet 升级到最新的 GroupDocs.Conversion 包: GroupDocs.Conversion 26.9.0

dotnet add package GroupDocs.Conversion --version 26.9.0

直接下载

从 GroupDocs.Conversion for .NET 26.9 页面下载程序集

资源