如何使用 IronWord 在 C# 中將 DOCX 轉換為 PDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord 透過其 ToPdf 方法,實現無縫的 DOCX 轉 PDF 轉換,支援需要標準化 PDF 輸出格式的自動化文件工作流程、報告分發及歸檔流程。

快速入門:使用 C# 將 DOCX 轉換為 PDF

使用 IronWord,透過單一方法呼叫即可載入 DOCX 檔案並將其轉換為 PDF。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronWord

    PM > Install-Package IronWord
  2. 複製並運行這段程式碼。

    using IronWord;
    
    WordDocument doc = new WordDocument("report.docx");
    doc.ToPdf("report.pdf");
  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronWord

    arrow pointer

如何將 DOCX 檔案轉換為 PDF?

ToPdf 方法在保留文件格式、圖片、表格及文字樣式的同時,處理了所有 PDF 生成的複雜性。 載入您的 DOCX 檔案並加入 new WordDocument("file.docx"),傳入輸出路徑後呼叫 ToPdf(),轉換程序便會自動完成。

:path=/static-assets/word/content-code-examples/how-to/word-to-pdf-basic.cs
using IronWord;

// Load existing DOCX file
WordDocument doc = new WordDocument("input.docx");

// Convert to PDF
doc.ToPdf("output.pdf");
$vbLabelText   $csharpLabel

提示ToPdf 方法在轉換過程中能完整保留文件內容,包括字型、顏色、圖片及版面配置。

此方法非常適用於自動化報告分發、發票生成,或任何需要標準化 PDF 輸出的工作流程。 轉換後的 PDF 檔案在所有平台和裝置上皆能呈現一致的外觀,非常適合用於官方文件、法律歸檔,以及對外交付成果等需要保持外觀一致性的場合。


如何將多個 DOCX 檔案轉換為 PDF?

針對大量文件處理,批次轉換功能可自動處理整個目錄。 使用 Directory.GetFiles() 檢索所有 DOCX 檔案,然後遍歷每個檔案並套用相同的轉換方法。 透過 try-catch 區塊進行錯誤處理,可確保損壞的檔案不會導致整個批次作業中斷。

:path=/static-assets/word/content-code-examples/how-to/word-to-pdf-batch.cs
using IronWord;
using System;
using System.IO;

// Get all DOCX files from input directory
string[] docxFiles = Directory.GetFiles("input-folder", "*.docx");

foreach (string filePath in docxFiles)
{
    try
    {
        // Load DOCX file
        WordDocument doc = new WordDocument(filePath);

        // Generate output PDF path
        string fileName = Path.GetFileNameWithoutExtension(filePath);
        string outputPath = $"output-folder/{fileName}.pdf";

        // Convert to PDF
        doc.ToPdf(outputPath);

        Console.WriteLine($"Converted: {fileName}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Failed: {Path.GetFileName(filePath)} - {ex.Message}");
    }
}
$vbLabelText   $csharpLabel

上述範例展示了實際的批次處理,並透過主控台記錄來追蹤進度。 此模式特別適用於檔案遷移專案、自動化工作流程管道,或需定期生成報告等情境,在這些情況下,往往需要將數百個 DOCX 檔案進行轉換,且無需人工介入。

處理大量批次時,請在轉換前確認原始檔案存在,並維持輸出檔名的命名規範一致。 可考慮採用並行處理以提升效能,但需監控系統資源,以防在並發操作期間發生記憶體耗盡的情況。

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/author_component.php

Line Number: 18

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 18
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'title'

Filename: sections/author_component.php

Line Number: 38

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 38
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'comment'

Filename: sections/author_component.php

Line Number: 48

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 48
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

準備好開始了嗎?
Nuget 下載 36,374 | 版本: 2026.3 剛剛發布
Still Scrolling Icon

還在捲動嗎?

想要快速證明? PM > Install-Package IronWord
執行範例 觀看您的資料變成 Word doc。