IRONSOFTWAREHOME
IRONSUITE所有10個程式庫只需支付2個的價格
聯絡銷售
按公司
使用IRONPDF

如何建立 Xamarin PDF 生成器

Curtis Chau
Curtis Chau
Updated: 2026年7月5日

在C#中，將Word文件轉換為PDF只需要三行程式碼與IronPDF：建立一個RenderDocxAsPdf，然後保存結果。 不需要安裝Microsoft Office，不需要COM互操作，不需要複雜的伺服器配置——只需一個NuGet包和.NET程式碼即可在任何環境中運行，包括雲端、Docker和Windows服務。

如何在ASP.NET項目中安裝IronPDF？

在Visual Studio中打開包管理器控制台，運行以下命令安裝IronPDF：

PM > Install-Package IronPdf

包安裝後，將using IronPdf;指令新增到您的C#文件中。 IronPDF目標.NET 8及更高版本，與ASP.NET核心、ASP.NET框架 4.6.2+和現代工作服務項目相容。 不需要額外的運行時組件或Microsoft Office授權。

在生產環境運行之前，請在應用啟動時設置您的授權金鑰，例如在Program.cs的頂部。 您可以從IronPdf.License.LicenseKey = configuration["IronPdf:LicenseKey"]!;。

IronPDF支持哪些.NET版本？

IronPDF支持以下平台：

IronPDF .NET平台相容性
平台最低版本備註
.NET8, 9, 10完全支持，推薦
.NET框架4.6.2僅限Windows
ASP.NET核心3.1+中間件和MVC控制器
Azure Functionsv4獨立進程模型
Docker / Linux任何需要libgdiplus

如何在C#中將Word文件轉換為PDF？

DocxToPdfRenderer類是所有Word到PDF轉換的進入點。 它接受文件路徑、字節陣列或PdfDocument物件。

這是最簡單的轉換方式：

using IronPdf;

// Set license key before first use
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("report.docx");
pdf.SaveAs("report.pdf");

在轉換過程中格式會發生什麼變化？

DocxToPdfRenderer在轉換過程中保留以下Word文件元素：

  • 文字格式——字型、大小、粗體、斜體、下划線、刪除線
  • 段落樣式——標題、正文、列表（有序和無序）
  • 表格——邊框、合併單元格、底紋和列寬
  • 圖片——內嵌和浮動圖片，保持原始解析度
  • 頁眉和頁腳——頁碼、日期和自定義內容
  • 頁面佈局——邊距、方向（縱向/橫向）、紙張大小

有關內嵌OLE物件或追蹤更改等邊緣情況的詳細行為說明，請參閱DocxToPdfRenderer文件。

如何將從流中載入的DOCX轉換？

當您接收到DOCX文件作為上傳或從資料庫blob中讀取它時，您可以直接將流傳遞給渲染器：

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using var docxStream = new FileStream("document.docx", FileMode.Open);
var renderer = new DocxToPdfRenderer();
var pdfDocument = renderer.RenderDocxAsPdf(docxStream);
pdfDocument.SaveAs("output.pdf");

此方法避免將臨時文件寫入磁碟，這在如Azure App Service等只讀文件系統環境中非常重要。

如何批量轉換多個DOCX文件？

當您需要處理整個文件資料夾時，迭代文件並重用單個DocxToPdfRenderer實例。 重用渲染器可以避免重複的初始化開銷：

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
string[] docxFiles = Directory.GetFiles(@"C:\WordDocuments", "*.docx");

foreach (string docxFile in docxFiles)
{
    var pdf = renderer.RenderDocxAsPdf(docxFile);
    string pdfPath = Path.ChangeExtension(docxFile, ".pdf");
    pdf.SaveAs(pdfPath);
    Console.WriteLine($"Converted: {Path.GetFileName(pdfPath)}");
}

輸入Word文件轉換為PDF文件

如何使用IronPDF將Word轉換為PDF ASP.NET：圖像 1 - 輸入Word文件與輸出PDF文件

輸出文件

如何使用IronPDF將Word轉換為PDF ASP.NET：圖像 2 - 原始Word文件和渲染的PDF文件在指定目錄中

對於高吞吐量的場景，請考慮使用Parallel.ForEach並行化迴圈。 如果您進行並行轉換，則每個執行緒建立一個DocxToPdfRenderer，因為該類在跨執行緒共享時不是執行緒安全的。

如何使用郵件合併生成個性化PDF？

郵件合併讓您可以定義帶有佔位符的DOCX模板，然後在運行時用資料填充這些佔位符。此模式非常適合用於發票、合同、證書和任何結構固定但內容隨收件人而不同的文件。

IronPDF的MailMergeDataSource屬性提供的自定義資料源：

using IronPdf;
using System.Data;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Build the data source
var data = new DataTable();
data.Columns.Add("CustomerName");
data.Columns.Add("InvoiceNumber");
data.Columns.Add("TotalAmount");
data.Rows.Add("Acme Corp", "INV-2026-001", "$4,500.00");

var renderer = new DocxToPdfRenderer();
renderer.MailMergeDataSource = data;

var pdf = renderer.RenderDocxAsPdf("invoice_template.docx");
pdf.SaveAs("acme_invoice.pdf");

在DOCX模板中，使用雙重尖角號（例如，<<CustomerName>>）來標記合併字段。 在轉換時，IronPDF會將每個佔位符替換成來自資料源的相應列值。 您可以在Microsoft Word郵件合併文件中了解更多關於文件自動化模式的資訊。

如何在DOCX轉換後保護PDF安全？

轉換後，您可以在保存之前直接在PdfDocument物件上應用密碼保護和權限限制。 當分發財務報告、法律協議或任何不應被隨意複製或列印的文件時，這很有用：

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("confidential.docx");

// Require a password to open the file
pdf.SecuritySettings.UserPassword = "user123";

// Owner password allows overriding restrictions
pdf.SecuritySettings.OwnerPassword = "owner456";

// Restrict printing and content copying
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SaveAs("secured_document.pdf");

PDF安全設置已應用

如何使用IronPDF將Word轉換為PDF ASP.NET：圖像 3 - PDF安全設置

IronPDF根據PDF版本使用128位和256位AES加密。 關於所有可用安全選項的更多詳細資訊，請參閱IronPDF安全文件。

下表總結了最常用的安全屬性：

IronPDF PdfDocument安全設置
屬性型別描述
UserPasswordstring打開文件需要的密碼
OwnerPasswordstring覆蓋所有限制的密碼
AllowUserPrintingPdfPrintSecurity枚舉控制列印權限
AllowUserCopyPasteContentbool允許或阻止文字複製
AllowUserAnnotationsbool允許或阻止註釋工具
AllowUserFormDatabool允許或阻止表單填寫

如何在ASP.NET核心控制器中整合DOCX到PDF的轉換？

要將Word到PDF轉換作為HTTP端點公開，請將轉換邏輯注入到控制器操作中。 以下範例接受多部分表單上傳，在記憶體中轉換文件，並將PDF作為可下載文件響應返回：

using IronPdf;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class DocumentController : ControllerBase
{
    [HttpPost("convert")]
    public IActionResult ConvertWordToPdf(IFormFile wordFile)
    {
        if (wordFile == null || wordFile.Length == 0)
            return BadRequest("Please upload a valid Word document.");

        using var stream = new MemoryStream();
        wordFile.CopyTo(stream);

        var renderer = new DocxToPdfRenderer();
        var pdfDocument = renderer.RenderDocxAsPdf(stream.ToArray());

        return File(pdfDocument.BinaryData, "application/pdf", "converted.pdf");
    }
}

如何在依賴注入容器中註冊IronPDF？

對於較大的應用程式，通過內建的ASP.NET核心依賴注入系統將DocxToPdfRenderer註冊為單例。 在builder.Services.AddSingleton<DocxToPdfRenderer>();。 將渲染器註冊為單例意味著物件只初始化一次，並在所有請求中重用，從而減少每個請求的開銷。 通過建構函式將其注入控制器和服務中，就像您注入任何其他依賴一樣。

應新增什麼樣的錯誤處理？

Word文件可能包含不支持的功能或格式不正確。 將轉換調用包裹在try/catch塊中，以處理IronPdfException並向調用者返回有意義的響應：

try
{
    var pdf = renderer.RenderDocxAsPdf(stream.ToArray());
    return File(pdf.BinaryData, "application/pdf", "output.pdf");
}
catch (IronPdfException ex)
{
    // Log the exception and return a 422 Unprocessable Entity
    return UnprocessableEntity($"Conversion failed: {ex.Message}");
}

良好的錯誤處理可以防止未處理的例外情況暴露給最終使用者，並大大簡化除錯轉換問題。

如何將轉換的PDF與現有文件合併？

一個常見的工作流涉及轉換DOCX求職信，然後將其新增到現有的PDF報告之前。 IronPDF的PDF合併功能使這一過程變為一次調用：

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var coverLetter = renderer.RenderDocxAsPdf("cover_letter.docx");
var existingReport = PdfDocument.FromFile("annual_report.pdf");

// Merge cover letter (first) with existing report (second)
var merged = PdfDocument.Merge(coverLetter, existingReport);
merged.SaveAs("final_document.pdf");

您可以根據需要合併多個PdfDocument.Merge。 對於更高級的文件組裝場景，請探索向現有PDF新增頁面或在轉換後的輸出上新增水印。

如何向轉換後的PDF新增水印或頁眉？

轉換DOCX文件後，您可以向每個頁面新增自定義頁眉、頁腳和文字印章。 這對於在生成的文件中新增批准狀態、機密性通知或品牌標誌非常有用：

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("proposal.docx");

// Add a text stamp on every page
pdf.ApplyStamp(new TextStamp("DRAFT", new TextStampStyle
{
    FontSize = 36,
    FontColor = IronSoftware.Drawing.Color.FromArgb(100, 200, 0, 0),
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center,
    Rotation = -45
}));

pdf.SaveAs("proposal_draft.pdf");

有關包含頁碼的基於HTML的頁眉和頁腳，請參閱IronPDF頁眉和頁腳文件。

如何將IronPDF與其他Word到PDF庫進行比較？

有多個庫可用於將DOCX文件轉換為.NET中的PDF。 了解權衡有助於您為您的用例選擇合適的工具。

Telerik文件處理（RadWordsProcessing）支持DOCX到PDF轉換，並包含在Telerik套件中。它完全在管理程式碼中運行，不需要本機依賴關係，但其對於複雜布局的渲染保真度可能與Word不同。 Aspose.Words是另一個具有高保真度和豐富API的已建立選擇，雖然它具有與IronPDF相似的按開發人員授權費用。

對於開源替代方案，DocX by Xceed提供DOCX操作，但不直接包含PDF轉換。 需要在Linux上使用無依賴選項的開發者也可以考慮從進程中調用無頭LibreOffice，但這會引入大的二進製依賴和進程產生開銷。

Word-to-PDF庫在.NET中的比較
庫渲染保真度需要Office支持Linux授權模型
IronPDF高否是按開發人員/ SaaS
Aspose.Words非常高否是按開發人員
Telerik RadWords中高否是Telerik套件
Microsoft.Office.Interop完美是否Office授權
LibreOffice無頭中否是開源（MPL）

在這次比較中，IronPDF的主要優勢是高保真度、無本機Office依賴、支持Linux及簡單的基於NuGet的安裝的結合。 對於已經使用IronPDF許可證進行HTML到PDF轉換的團隊，DOCX渲染器包含在內，不需額外費用。

IronPDF如何在內部處理DOCX文件格式？

IronPDF直接讀取Office Open XML（OOXML）格式——Microsoft Word使用的相同規範。 它不會在背景中調用Word，也不使用COM自動化橋接。 這意味著轉換在您的.NET應用程式中運行，這使其預測、可預測且對多執行緒伺服器工作負載安全。

內部管道解析OOXML XML包，解析嵌入資源（圖像、字體、嵌入物件），應用段落和運行格式，根據文件的區段屬性佈局頁面幾何，並將結果光柵化進PDF內容流中。 PDF規範(ISO 32000)管理輸出格式，確保與所有主流PDF查看器的相容性。

您的下一步該怎麼做？

您現在擁有將Word文件轉換為PDF的堅固基礎，適用於任何.NET或ASP.NET應用程式。 接下來您可以探索以下內容：

  • 下載並試用IronPDF——從免費試用開始，先在您的項目中測試完整功能集，然後再決定購買授權。
  • 閱讀DOCX轉換指南——DocxToPdfRenderer操作指南深入介紹邊界情況、高級選項及性能調整。
  • 探索HTML到PDF——如果您的工作流涉及HTML模板或Razor視圖，IronPDF可以用相同流暢的API表面將HTML轉換為PDF。
  • 合併和拆分文件——了解如何將多個PDF合併為一個文件，或將大PDF拆分為獨立頁面。
  • 新增數位簽名——對於法律或合規流程，IronPDF支持使用X.509證書的PDF數位簽名。
  • 查看授權選項——探索按開發人員、網站及OEM授權，找出適合您的部署模式的計劃。
  • 瀏覽部落格——IronPDF部落格包含關於PDF生成、操作、OCR整合等的教程。
Curtis Chau
Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...
閱讀更多

相關文章

Key in blue circle

立即免費取得 30 天試用金鑰。

Your trial license will be sent to your email address

無任何限制。100% 解鎖。無需信用卡。

OR
bullet_checked無需信用卡或建立帳號無任何限制。100% 解鎖。無需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
預訂您的免費現場演示
Booking Badge

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密。
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰。
無需信用卡或帳戶建立
C# 用於PDF的NuGet程式庫
使用NuGet安裝

版本： 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解決方案資源管理器，右鍵點選參考，管理NuGet包
  2. 選擇瀏覽並搜尋"IronPdf"
  3. 選擇套件並安裝
C# PDF DLL
下載DLL

版本： 2026.9

或者點擊此處下載Windows安裝程式。

  1. 下載並解壓IronPDF到類似~/Libs的位置，位於您的解決方案目錄中
  2. 在Visual Studio解決方案資源管理器，右鍵點選參考。選擇瀏覽，"IronPdf.dll"

授權從$999起