IronPDF Quickstart Guide

Curtis Chau

已更新:七月 12, 2025

Translated

View the article in English

安装 IronPDF 并在五分钟内创建您的第一个 PDF。通过其简单的 API，您可以将 HTML、DOCX、图像等转换为像素完美的 PDF。

1. 先决条件

.NET Framework 4.6.2+ 或 .NET Core 3.1+ 或 .NET 5+
Visual C++ Redistributable (适用于 Windows)。

<hr

2. 安装 IronPDF

标准的 IronPDF 安装在本地运行。如果您想在 Docker/微服务上部署，请查看远程引擎模式指南。

Install IronPDF with NuGet Package Manager

PM > Install-Package IronPdf

Copy and run this code snippet.

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

Deploy to test on your live environment

Start using IronPDF in your project today with a free trial

Free 30 day Trial

data-active-tab="1">

class="installation-options__tabs">

data-tab="1"> NuGet 包管理器

data-tab="2"> DLL 下载

data-tab="1">

data-tab="2">

id="nuget-package-manager-start">

转到 IronPDF NuGet 库:

在解决方案资源管理器中，右键单击引用
选择 '管理 NuGet 包' > '浏览' > 搜索 IronPdf

Install-Package IronPdf

id="nuget-package-manager-end">

id="dll-download-start">

下载 IronPDF DLL 包
将你的操作系统的 ZIP 文件解压到你的解决方案目录中的一个位置
在 Visual Studio 解决方案资源管理器中，右键单击 'Dependencies'
'添加项目引用' > 选择 '浏览' 以包含从 Zip 中提取的所有 DLL。

class="related-link">相关： 更多关于配置设置

id="dll-download-end">

平台特定指南

class="col-2">

class="platform-guide__icon">

class="platform-guide__title">Windows

class="col-2">

class="platform-guide__icon">

class="platform-guide__title">Linux

class="col-2">

class="platform-guide__icon">

class="platform-guide__title">MacOS

class="col-2">

class="platform-guide__icon">

class="platform-guide__title">Docker

class="col-2">

class="platform-guide__icon">

class="platform-guide__title">Azure

class="col-2">

class="platform-guide__icon">

class="platform-guide__title">AWS

<hr

3. 应用许可证密钥

当您购买 IronPDF 许可证或选择开始 30 天试用时，许可证密钥将被发送到您的邮箱。复制密钥并将其添加到您的应用程序的开头。

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

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

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"

$vbLabelText $csharpLabel

class="related-link">查看 IronPDF 许可

<hr

4. 创建您的第一个 PDF

class="related-link">IronPDF 帮助您创建 PDF 或将 HTML、DOCX、RTF、Markdown 和图像转换为 PDF，同时保持完全保真。探索更多类型的 PDF 转换

在 .cs 文件的顶部添加这一行。

using IronPdf;

using IronPdf;

Imports IronPdf

$vbLabelText $csharpLabel

data-active-tab="1">

class="installation-options__tabs">

data-tab="1"> 创建一个空白 PDF

data-tab="2"> 将 HTML 字符串转换为 PDF

data-tab="3"> 将 DOCX 转换为 PDF

data-tab="1">

data-tab="2">

data-tab="3">

id="create-a-blank-pdf-start">

创建 PDF 对象的最简单方法只需使用宽度和高度。这个 PdfDocument 构造函数创建一个空白 PDF，准备进行自定义。

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

id="create-a-blank-pdf-end">

id="convert-html-string-to-pdf-start">

使用 ChromePdfRenderer.RenderHtmlAsPdf 方法，您可以使用内嵌的 Chromium 引擎将任何 HTML（包括 HTML5）转换为 PDF。

using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");

using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

class="related-link">相关操作指南： 如何在 C# 中将 HTML 字符串转换为 PDF

id="convert-html-string-to-pdf-end">

id="convert-docx-to-pdf-start">

使用 DocxToPdfRenderer 类将 Word 文档转换为 PDF，您可以将 DOCX 文件直接渲染为可自定义的 PDF，便于与 .NET 应用程序无缝集成。

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");

Imports IronPdf

Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")

$vbLabelText $csharpLabel

class="related-link">相关操作指南： 如何在 C# 中将 Microsoft Word 转换为 PDF

id="convert-docx-to-pdf-end">

<hr

5. 更多高级示例

除了简单的 PDF 创建和转换，IronPDF 还提供更强大的 PDF 自定义选项。

data-active-tab="1">

class="installation-options__tabs">

data-tab="1"> 添加页头和页脚

data-tab="2"> 隐藏文本

data-tab="3"> 合并 PDF

data-tab="1">

data-tab="2">

data-tab="3">

id="add-headers-and-footers-start">

通过实例化 TextHeaderFooter，添加你的文本，并将其附加到 PDF 上来创建文本页头或页脚。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

class="related-link">相关操作指南： 如何添加页头和页脚

id="add-headers-and-footers-end">

id="redact-text-start">

使用 RedactTextOnAllPages 轻松隐藏文本，以删除整个文档中的某个短语。

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")

' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")

pdf.SaveAs("redacted.pdf")

$vbLabelText $csharpLabel

class="related-link">相关操作指南： 如何将 URL 渲染为 PDF

id="redact-text-end">

id="merge-pdfs-start">

使用 Merge 方法在 C# 中合并两个 PDF 文件。在任何新的或导入的 PdfDocument 上使用 ReplaceTextOnAllPages，以旧文本替换为新文本。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

pdf.SaveAs("replaceText.pdf")

$vbLabelText $csharpLabel

class="related-link">相关操作指南： 如何合并或拆分 PDF

id="merge-pdfs-end">

<hr

快速故障排除

class="quick-troubleshooting">

问题	解决方案
缺少 Visual C++ 运行时	安装 Visual C++ Redistributable - Chrome 引擎需要同时安装 x86 和 x64 版本
许可证未被识别	通过 `IronPdf.License.IsLicensed` 属性进行验证。确保在任何 IronPDF 操作之前应用许可证
第一次渲染缓慢	在启动时调用 `IronPdf.Installation.Initialize()` 以预先初始化渲染引擎
Linux/Docker 依赖项	设置 `Installation.LinuxAndDockerDependenciesAutoConfig = true` 以实现自动依赖项安装