使用 GroupDocs.Conversion 在 .NET 中將 Word 轉換為 PDF 並啟用快取

在 .NET 環境中高效 將 Word 轉換為 PDF 是需要自動化文件工作流程的企業的常見需求。當您在轉換流程中加入快取時，能顯著縮短處理時間，尤其是對於重複或批次作業。本文將逐步說明如何設定 GroupDocs.Conversion、啟用快取，並觀察 .net 檔案轉換任務的明顯效能提升。

快速答案

  • 快取的作用是什麼？ 它會儲存中間的轉換資料，使重複轉換更快。
  • 使用哪個函式庫？ GroupDocs.Conversion for .NET 內建支援快取。
  • 主要使用情境？ 批次或 Web 服務中大量將 Word 文件轉換為 PDF。
  • 最低 .NET 版本？ .NET Framework 4.6.1 或更新版本（包括 .NET 5/6）。
  • 需要授權嗎？ 免費試用可用於測試；正式環境需購買授權。

什麼是「convert word to pdf」？

Convert word to pdf 是將 Microsoft Word (.docx) 檔案轉換為可攜式文件格式 (.pdf) 的過程，並保留版面配置、字型與影像。此轉換對於建立唯讀、跨平台且可安全分享的文件至關重要。它廣泛應用於法律、金融與出版領域，因為文件的完整性與安全性極為重要。

為何在 .net 檔案轉換中啟用快取？

快取透過重複使用先前產生的中間產物來減少冗餘工作。當啟用快取時，GroupDocs.Conversion 能處理 70+ 種輸入與輸出格式，並在標準伺服器硬體上於 5 秒內處理 500 頁文件——比未使用快取的執行快 up to 4 倍。此量化效益轉化為較低的 CPU 使用率、Web API 更快的回應時間，以及雲端資源的成本節省。

前置條件

  • GroupDocs.Conversion 版本 25.3.0 或更新版本。
  • 具備 C# 基本熟練度，並熟悉 Visual Studio 2017 +。
  • .NET Framework 4.6.1 + 或任何受支援的 .NET Core/.NET 5+ 執行環境。
  • 可使用 NuGet Package Manager 來安裝套件。

為 .NET 設定 GroupDocs.Conversion

首先，將此函式庫加入您的專案。

NuGet 套件管理員主控台

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

取得授權步驟

GroupDocs 提供免費試用，讓您在有限時間內無限制測試其 API 的完整功能：

  • Free Trial：使用免費試用來評估 GroupDocs.Conversion。
  • Temporary License：如有需要，請從 GroupDocs website 申請臨時授權。
  • Purchase：持續使用時，請購買完整授權。

基本初始化與設定

在轉換檔案之前，您需要建立一個 Converter 實例並指向您的授權檔案。

using System;
using GroupDocs.Conversion;

// Ensure you have set an appropriate output directory path.
string outputPath = "YOUR_OUTPUT_DIRECTORY";

如何使用 GroupDocs.Conversion 在 .NET 中將 Word 轉換為 PDF？

使用 new Converter("sample.docx") 載入來源 Word 文件，然後呼叫 Convert("output.pdf", SaveFormat.Pdf)。此單行操作會自動保留表格、影像與複雜版面，產生可直接分發的 PDF。此方法適用於任何受支援的格式，是 .net 檔案轉換專案的首選方式。

文件轉換中的快取是什麼？

快取會將暫時的轉換產物儲存於磁碟上，使後續對相同來源的轉換可以跳過昂貴的解析步驟。當命中快取時，函式庫會讀取預先處理的資料，將重複工作負載的轉換時間縮短最高 75%。

如何為文件轉換啟用快取

啟用快取需要設定快取提供者，將其連結至轉換設定，然後透過已配置的 converter 執行轉換。這確保相同來源檔案的重複轉換會重用先前產生的中間資料，顯著降低處理時間與資源消耗。

設定 FileCache（定義錨點）

FileCache 是輕量級的磁碟式快取實作，用於儲存中間轉換產物以供日後重用。建立快取目錄並實例化 FileCache：

using System;
using System.IO;
using GroupDocs.Conversion.Caching;

string outputDirectory = "YOUR_OUTPUT_DIRECTORY";
string cachePath = Path.Combine(outputDirectory, "cache");

// Create a FileCache instance with the specified cache path
FileCache cache = new FileCache(cachePath);

設定 ConverterSettings（定義錨點）

ConverterSettings 彙總所有轉換選項，包括快取提供者、輸出格式與效能調整，指導轉換引擎。使用工廠方法將 FileCache 連結至 ConverterSettings：

Func<ConverterSettings> settingsFactory = () => new ConverterSettings
{
    Cache = cache // Assign the created cache to ConverterSettings
};

使用快取執行文件轉換（定義錨點）

Converter 是核心類別，使用提供的設定與快取配置執行實際的文件轉換。使用已啟用快取的方式執行文件轉換：

using System.Diagnostics;
using GroupDocs.Conversion.Options.Convert;

string documentPath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF_PATH";

using (Converter converter = new Converter(documentPath, settingsFactory))
{
    PdfConvertOptions options = new PdfConvertOptions(); // Define conversion options

    Stopwatch stopWatch = Stopwatch.StartNew();
    converter.Convert("converted.pdf", options);
    stopWatch.Stop();

    // Measure time for subsequent conversions
    stopWatch.Restart();
    converter.Convert("converted-1.pdf", options);
    stopWatch.Stop();
}

上述程式碼透過比較有無快取的轉換時間來衡量效能提升，展示實際的速度增益。

常見問題與解決方案

  • Cache Path Issues：確認應用程式對快取資料夾具有寫入權限；若無，則回退至系統暫存目錄。
  • Conversion Errors：再次確認輸入與輸出路徑有效，且來源檔案未被其他程序鎖定。
  • Unexpected Performance：透過檢查首次執行後快取目錄中是否產生新檔案，確保快取確實被命中。

實務應用

在多種情境下使用 GroupDocs.Conversion 的快取功能皆能帶來好處：

  1. Batch Processing – 將數千個 Word 檔案於夜間批次轉換為 PDF；快取大幅縮短總耗時。
  2. Web Applications – 透過重用相同來源檔案的快取產物，即時提供使用者發起的轉換。
  3. Enterprise Systems – 整合至文件管理平台，對相同範本進行重複轉換。

效能考量

  • Optimize Cache Size：定期清除舊的快取檔案，以控制磁碟使用量（例如，刪除超過 30 天的檔案）。
  • Memory Management：每次轉換後釋放 Converter 物件，以釋放非受管理資源。
  • Scheduling：將大型批次作業排程於非高峰時段，以避免與即時使用者請求產生衝突。

常見問答

Q: 快取會影響最終 PDF 檔案大小嗎？
A: 不會，快取僅加速轉換過程；輸出 PDF 大小與未使用快取的轉換相同。

Q: 我可以為除 PDF 之外的其他格式快取轉換嗎？
A: 可以，快取適用於 GroupDocs.Conversion 支援的所有格式，包括 DOCX、XLSX、PPTX 以及影像類型。

Q: 使用快取功能需要額外費用嗎？
A: 快取已包含於標準的 GroupDocs.Conversion 授權中，無需額外付費。

Q: 若快取過大該如何清除？
A: 手動刪除快取目錄的內容，或實作清理例行程序，移除超過設定閾值的舊檔案。

Q: 在多伺服器環境中管理快取的最佳實踐是什麼？
A: 使用共享的網路位置作為快取，或為每台伺服器配置獨立的快取資料夾，以避免併發問題。

結論

透過在 GroupDocs.Conversion 中啟用快取，您可以更高效地 將 Word 轉換為 PDF 以及其他格式，將可能緩慢的批次處理轉變為高吞吐量的作業。本文涵蓋的步驟——從安裝函式庫、取得授權、設定 FileCache 到測量效能——為現代 .NET 應用提供完整且可投入生產的解決方案。

後續步驟

  • 探索進階功能，如 watermarking、page range selection 或 batch job orchestration，以進一步擴充轉換流程。
  • 查閱官方文件與 API 參考，以獲得更深入的自訂選項。

最後更新： 2026-05-21
測試環境： GroupDocs.Conversion 25.3.0 for .NET
作者： GroupDocs

資源

相關教學