使用IRONPDF

如何在 C# 中将 Word (Docx) 转换为 PDF（教程）

更新 2025年一月30日

IronWord 是 Iron Software 的全新 .NET Word 文档库，具有简化 Word 和 DOCX 文档的创建、阅读和编辑的尖端功能。开始使用 IronWord 今天!

介绍

将Word文档转换为PDF是在许多商业应用程序中的常见需求，从自动生成报告到提供专业质量的文档。 PDF 文件因其一致的格式、安全的功能和易于共享而被普遍认可。

在本教程中，我们将指导您完成将 Word 文档转换的过程。(DOCX 文件)使用 C# 将文件转为 PDFIronPDF图书馆本分步指南将帮助您快速无缝地将Word到PDF的功能集成到您的.NET应用程序中。

先决条件

在开始本教程之前，请确保您具备以下条件：

开发环境
- 一个正在运行的 Visual Studio 安装(建议2019年或更高版本).
- 安装.NET 6.0或兼容的.NET框架。
IronPDF 库
- 通过 NuGet 安装 IronPDF
- 有效的IronPDF许可证密钥
一个示例Word文档
- 准备一个DOCX文件(例如，example.docx)用于测试。您可以使用 Microsoft Word、Google Docs 创建一个。(导出为 DOCX)，或任何兼容的编辑器。
基础C#知识
- 熟悉 C# 中基本的文件输入/输出操作。

为什么将Word文件转换为PDF？

PDF 相较于 DOCX 的优势

由于其以下特点，PDF 是共享和存档文档的黄金标准：

平台独立性：PDF文件无论使用什么操作系统或设备打开，看起来都是一样的。
数据完整性：文本、图像、字体和布局完全按照预期保留。
安全性：PDF支持加密、密码保护和数字签名，确保文档的机密性和真实性。

Word 转 PDF 转换的常见场景

以下是一些将 Word 转换为 PDF 至关重要的实际场景：

合同和法律文件：生成保持格式且不易编辑的合同。
商务报告：共享格式一致的精美专业报告。
发票生成：自动化生成防篡改格式的发票。
文档归档：将重要的Word文档保存为长期不可修改的格式。

设置IronPDF库

要跟随这篇教程，您需要使用IronPDF库。

步骤 1：安装 IronPDF

IronPDF可通过NuGet获得。打开您的包管理器控制台并运行：

Install-Package IronPdf

Install-Package IronPdf

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronPdf

VB C#

或者，您可以通过 Visual Studio 中的 NuGet 包管理器安装它。只需转到工具 > NuGet 包管理器 > 管理解决方案的 NuGet 包：

Word To Pdf Csharp Tutorial 1 related to 步骤 1：安装 IronPDF

然后搜索IronPDF。您可以在此将 IronPDF 库安装到您的项目中。

Word To Pdf Csharp Tutorial 2 related to 步骤 1：安装 IronPDF

步骤 2：激活您的许可证

IronPDF 提供免费试用，您需要激活许可证密钥以获得完整功能。要激活，只需在代码中添加您的许可证密钥：

IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

VB C#

输入 Word 文档

Word To Pdf Csharp Tutorial 3 related to 输入 Word 文档

基本示例代码

下面的示例代码演示了将DOCX文件转换为PDF的简单过程。

using IronPdf;  
using System.IO;  

class Program  
{  
    static void Main(string[] args)  
    {  
        DocxToPdfRenderer renderer = new DocxToPdfRenderer();

    // Convert DOCX to PDF using IronPDF  
    PdfDocument pdf = renderer.RenderDocxAsPdf("newsletter.docx");

    // Save the resulting PDF to a file  
    pdf.SaveAs("output.pdf"); 
    }  
}

using IronPdf;  
using System.IO;  

class Program  
{  
    static void Main(string[] args)  
    {  
        DocxToPdfRenderer renderer = new DocxToPdfRenderer();

    // Convert DOCX to PDF using IronPDF  
    PdfDocument pdf = renderer.RenderDocxAsPdf("newsletter.docx");

    // Save the resulting PDF to a file  
    pdf.SaveAs("output.pdf"); 
    }  
}

Imports IronPdf
Imports System.IO

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer As New DocxToPdfRenderer()

	' Convert DOCX to PDF using IronPDF  
	Dim pdf As PdfDocument = renderer.RenderDocxAsPdf("newsletter.docx")

	' Save the resulting PDF to a file  
	pdf.SaveAs("output.pdf")
	End Sub
End Class

VB C#

输出 PDF 文档

Word To Pdf Csharp Tutorial 4 related to 输出 PDF 文档

代码解释

为了开始将您的DOCX文件转换为PDF，我们首先需要实例化DocxToPdf 渲染器. 这将处理将您的 Word 文档转换为 PDF 格式。下一步是创建一个新的PdfDocument实例将保存新创建的PDF文档，并使用RenderDocxAsPdf方法将DOCX文件转换为PDF。最后，您只需使用SaveAs将PDF文档保存到所需位置即可，瞧。! 您只需三行代码即可将DOCX文件转换为PDF。

增强 PDF 的高级功能

IronPDF 配备了高级功能，可帮助您自定义和丰富 PDF 输出：

添加水印

水印有助于品牌推广或标记敏感文档。您可以添加水印转换 PDF 后：

pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE Copy</h2>", 40, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center);

pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE Copy</h2>", 40, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center);

pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE Copy</h2>", 40, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center)

VB C#

2. 将页眉添加到您的PDF

最常见的PDF自定义之一是添加页眉给每一页。页眉可以包含文档标题、页码、日期或您希望在每页顶部显示的任何其他信息。

TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "Weekly Newsletter!",
};

pdf.AddTextHeaders(textHeader);

TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "Weekly Newsletter!",
};

pdf.AddTextHeaders(textHeader);

Dim textHeader As New TextHeaderFooter With {.CenterText = "Weekly Newsletter!"}

pdf.AddTextHeaders(textHeader)

VB C#

3. 自定义PDF布局

IronPDF允许您定义页面设置，例如利润, 定位和页面大小在保存您的 PDF 之前：

renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.portrait;

renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(20, 20);

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
renderer.RenderingOptions.MarginBottom = 30;

renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.portrait;

renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(20, 20);

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
renderer.RenderingOptions.MarginBottom = 30;

renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.portrait

renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(20, 20)

renderer.RenderingOptions.MarginTop = 30
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 30

VB C#

完整示例代码与额外格式

using IronPdf;
using IronPdf.Rendering;

public class Program
{

    public static void Main(string[] args)
    {
        DocxToPdfRenderer renderer = new DocxToPdfRenderer();

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;

        renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

        renderer.RenderingOptions.MarginTop = 15;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;
        renderer.RenderingOptions.MarginBottom = 15;

        // Convert DOCX to PDF using IronPDF  
        PdfDocument pdf = renderer.RenderDocxAsPdf("newsletter.docx");

        pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE Copy</h2>", 40, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center);

        TextHeaderFooter textHeader = new TextHeaderFooter
        {
            CenterText = "Weekly Newsletter!",
        };

        pdf.AddTextHeaders(textHeader);

        // Save the resulting PDF to a file  
        pdf.SaveAs("output.pdf");
    }
}

using IronPdf;
using IronPdf.Rendering;

public class Program
{

    public static void Main(string[] args)
    {
        DocxToPdfRenderer renderer = new DocxToPdfRenderer();

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;

        renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

        renderer.RenderingOptions.MarginTop = 15;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;
        renderer.RenderingOptions.MarginBottom = 15;

        // Convert DOCX to PDF using IronPDF  
        PdfDocument pdf = renderer.RenderDocxAsPdf("newsletter.docx");

        pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE Copy</h2>", 40, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center);

        TextHeaderFooter textHeader = new TextHeaderFooter
        {
            CenterText = "Weekly Newsletter!",
        };

        pdf.AddTextHeaders(textHeader);

        // Save the resulting PDF to a file  
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports IronPdf.Rendering

Public Class Program

	Public Shared Sub Main(ByVal args() As String)
		Dim renderer As New DocxToPdfRenderer()

		renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait

		renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)

		renderer.RenderingOptions.MarginTop = 15
		renderer.RenderingOptions.MarginLeft = 20
		renderer.RenderingOptions.MarginRight = 20
		renderer.RenderingOptions.MarginBottom = 15

		' Convert DOCX to PDF using IronPDF  
		Dim pdf As PdfDocument = renderer.RenderDocxAsPdf("newsletter.docx")

		pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE Copy</h2>", 40, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center)

		Dim textHeader As New TextHeaderFooter With {.CenterText = "Weekly Newsletter!"}

		pdf.AddTextHeaders(textHeader)

		' Save the resulting PDF to a file  
		pdf.SaveAs("output.pdf")
	End Sub
End Class

VB C#

通过这个功能，您可以轻松地将DOCX文件转换为PDF文件，并进行自定义格式以满足您的需求。

输出 PDF 文档

Word To Pdf Csharp Tutorial 5 related to 输出 PDF 文档

Word 到 PDF 转换的最佳实践

优化文件大小

减少PDF大小由压缩PDF中的任何图像，以实现更快的下载和更流畅的共享：

pdf.CompressImages(40);

pdf.CompressImages(40);

pdf.CompressImages(40)

VB C#

2. 验证输入文件

在处理之前，始终确保DOCX文件存在且有效：

if (!File.Exists(docxPath))  
{  
    throw new FileNotFoundException($"File not found: {docxPath}");  
}

if (!File.Exists(docxPath))  
{  
    throw new FileNotFoundException($"File not found: {docxPath}");  
}

If Not File.Exists(docxPath) Then
	Throw New FileNotFoundException($"File not found: {docxPath}")
End If

VB C#

3. 保障您的PDF文件

使用密码加密敏感文档：

pdf.SecuritySettings.OwnerPassword = "SecurePassword123";
pdf.SecuritySettings.UserPassword = "Password";

pdf.SecuritySettings.OwnerPassword = "SecurePassword123";
pdf.SecuritySettings.UserPassword = "Password";

pdf.SecuritySettings.OwnerPassword = "SecurePassword123"
pdf.SecuritySettings.UserPassword = "Password"

VB C#

关于 IronPDF

IronPDF 是一个功能强大的 .NET 库，允许开发人员轻松创建、操作和转换 PDF 文档。它提供了一系列功能，旨在帮助您在C#应用程序中实现文档生成和处理的自动化和精简。无论您是将 HTML、DOCX 或图像文件转换为 PDF，还是从现有的 PDF 中编辑和提取文本，IronPDF 通过最少的编码简化了这些任务。

IronPDF 的主要功能

将 HTML 转换为 PDF**：
- IronPDF的最强大功能之一是其转换能力HTML 内容转化为 PDF 文件。这使其非常适合需要以PDF格式下载报告、发票或其他文档的Web应用程序。
- 它支持高级 HTML 和 CSS，包括 JavaScript 执行，确保 PDF 输出与网页设计高度一致。
图像转换为PDF
- IronPDF 也可以处理图像(JPEG、PNG等。)和Convert它们转换为高质量的PDF，非常适合创建作品集、照片书和扫描文档档案。此外，IronPDF 还支持 PDF 转换为图像。
PDF编辑:
- 您可以通过添加文本、图像、形状、注释或水印来编辑现有的PDF。该库还支持合并和拆分PDF文件，使其成为文档管理应用程序的理想工具。
表单填写和PDF生成
- IronPDF 允许开发人员填写现有 PDF 中的表单字段，非常适合用户需要填写交互式表单并将其保存为 PDF 的应用程序。
文本提取
- IronPDF可以Excerpt从PDF中提取，可用于数据分析、搜索或导出到其他格式(如CSV或Excel). 这对于需要分析 PDF 内容的文档处理工作流程非常理想。

结论

IronPDF使通过C#编程将Word文档转换为PDF变得简单、可靠且功能丰富。只需几行代码，您就可以将此功能集成到您的.NET应用程序中，使用户能够从DOCX文件生成专业的高质量PDF。

通过利用IronPDF，开发人员可以简化以下工作流程：

为企业自动化生成文档。
确保在跨平台共享文件时的数据完整性。
创建安全、防篡改的重要Word文档档案。

此外，高级功能（例如水印、合并文件和应用自定义布局）使您能够超越基本的转换。这些功能非常适用于在合同管理、发票生成和报告分发等领域构建强大的解决方案。

IronPDF 以其简单性、多功能性和对开发者友好的 API 而脱颖而出，使其成为任何从事 .NET 文档处理工作的人员必不可少的工具。亲自尝试IronPDF及其免费试用，看看它如何改善您的PDF项目!

雷根·彭

软件工程师

LinkedIn

Regan毕业于雷丁大学，拥有电子工程学士学位。在加入Iron Software之前，他的前工作职位要求他专注于单一任务；他在Iron Software最喜欢的是能进行多种工作，无论是增加销售价值、技术支持、产品开发还是营销。他喜欢了解开发人员如何使用Iron Software的库，并利用这些知识不断改进文档和开发产品。

< 前一页
PDF查看器C# Windows应用程序（教程）

下一步 >
如何在C#中读取PDF文件