我們很高興宣佈 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 Text Sequence 作為 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)
- [改進] 移除過時的 converter listener、fluent handler 階段與頁面尺寸屬性 (CONVERSIONNET-8561)
- [錯誤] PPTX 轉 PDF:在 Linux 上雙底線與雙刪除線會產生 NaN 座標 (CONVERSIONNET-8388)
- [錯誤] 轉換超過 4 頁的 PDF 時在評估模式下失敗 (CONVERSIONNET-8515)
- [錯誤] 將 PDF 轉為 Web 時未套用試用頁數限制 (CONVERSIONNET-8516)
- [錯誤] 回傳正確的多頁 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(...) after .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
透過 NuGet 升級至最新的 GroupDocs.Conversion 套件:GroupDocs.Conversion 26.9.0
dotnet add package GroupDocs.Conversion --version 26.9.0
直接下載
從 GroupDocs.Conversion for .NET 26.9 頁面下載組件。