使用IRONPDF

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

更新 2025年一月30日
分享:

介绍

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

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

先决条件

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

  1. 开发环境

    • 一个正在运行的 Visual Studio 安装(建议2019年或更高版本).

    • 安装.NET 6.0或兼容的.NET框架。
  2. IronPDF 库

    • 通过 NuGet 安装 IronPDF

    • 有效的IronPDF许可证密钥
  3. 一个示例Word文档

    • 准备一个DOCX文件(例如,example.docx)用于测试。 您可以使用 Microsoft Word、Google Docs 创建一个。(导出为 DOCX),或任何兼容的编辑器。
  4. 基础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 的主要功能

  1. HTML 转换为 PDF**:

    • IronPDF的最强大功能之一是其转换能力HTML 内容转化为 PDF 文件。 这使其非常适合需要以PDF格式下载报告、发票或其他文档的Web应用程序。

    • 它支持高级 HTML 和 CSS,包括 JavaScript 执行,确保 PDF 输出与网页设计高度一致。
  2. 图像转换为PDF

    • IronPDF 也可以处理图像(JPEG、PNG等。)和Convert它们转换为高质量的PDF,非常适合创建作品集、照片书和扫描文档档案。 此外,IronPDF 还支持 PDF 转换为图像。
  3. PDF编辑:

    • 您可以通过添加文本、图像、形状、注释或水印来编辑现有的PDF。 该库还支持合并和拆分PDF文件,使其成为文档管理应用程序的理想工具。
  4. 表单填写和PDF生成

    • IronPDF 允许开发人员填写现有 PDF 中的表单字段,非常适合用户需要填写交互式表单并将其保存为 PDF 的应用程序。
  5. 文本提取

    • IronPDF可以Excerpt从PDF中提取,可用于数据分析、搜索或导出到其他格式(如CSV或Excel). 这对于需要分析 PDF 内容的文档处理工作流程非常理想。

结论

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

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

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

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

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

< 前一页
PDF查看器C# Windows应用程序(教程)
下一步 >
如何在C#中读取PDF文件