我们很高兴宣布 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 页面下载程序集