我們很高興宣佈 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 頁面下載組件。

資源