IronPDF 快速入门指南
安装 IronPDF，只需五分钟即可创建您的第一个 PDF。利用其简单的 API，你可以将 HTML、DOCX、图片等转换成像素级的完美 PDF。
1. 先决条件
- .NET Framework 4.6.2+ 或 .NET Core 3.1+ 或 .NET 5+
- Visual C++ Redistributable (适用于 Windows)。
2. 安装 IronPDF
标准的 IronPDF 安装在本地运行。 如果您想在 Docker/微服务上部署，请查看 远程引擎模式指南。
-
1Install IronPDF with NuGet Package Manager
-
2复制并运行这段代码。
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");C# -
3部署到您的生产环境中进行测试
通过免费试用立即在您的项目中开始使用IronPDF
- 在解决方案资源管理器中，右键单击引用
- 选择'管理NuGet包'>'浏览'>搜索IronPDF
- 下载 IronPDF DLL 包。
- 将适用于您操作系统的 ZIP 文件解压缩到 "解决方案 "目录下的某个位置
- 在 Visual Studio 解决方案资源管理器中，右键单击 "依赖项
- 添加项目参考"> 选择 "浏览 "以包含从压缩包中提取的所有 DLL。
平台特定指南
3. 应用许可证密钥
当您购买 IronPDF 许可证 或选择开始 30 天试用时，许可证密钥将被发送到您的邮箱。 复制密钥并将其添加到您的应用程序的开头。
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";Imports IronPdf
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"4. 创建您的第一个 PDF
在 .cs 文件的顶部添加这一行。
using IronPdf;Imports IronPdf创建一个PDF对象的最简单方法只需使用宽度和高度。 此PdfDocument构造函数创建一个空白PDF，准备进行自定义。
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")使用ChromePdfRenderer.RenderHtmlAsPdf方法，您可以使用嵌入的Chromium引擎将任何HTML（包括HTML5）转换为PDF。
using IronPdf;
IronPdf.ChromePdfRenderer
.StaticRenderHtmlAsPdf("<p>Hello World</p>")
.SaveAs("string-to-pdf.pdf");使用DocxToPdfRenderer类将Word文档转换为PDF，您可以将DOCX文件直接渲染为可定制的PDF，无缝集成到.NET应用中。
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")5. 更多高级示例
除了简单的 PDF 创建和转换，IronPDF 还提供更强大的 PDF 自定义选项。
通过实例化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");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)
pdf.SaveAs("addTextHeaderFooter.pdf")使用RedactTextOnAllPages轻松编辑文本，以删除整个文档中的某个短语。
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")使用Merge方法在C#中合并两个PDF文件。 在任何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");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")快速故障排除
| 问题 | 解决方案 |
|---|---|
| 缺少 Visual C++ 运行时 | 安装 Visual C++ Redistributable - Chrome 引擎需要 x86 和 x64 两个版本 |
| 许可证无法识别 | 使用 IronPdf.License.IsLicensed 属性进行验证。确保在任何 IronPDF 操作之前应用许可证 |
| 首次渲染速度慢 | 在启动时调用 IronPdf.Installation.Initialize() 以预初始化渲染引擎 |
| Linux/Docker 依赖性 | 设置 Installation.LinuxAndDockerDependenciesAutoConfig = true 以自动安装依赖项 |
下一步
常见问题解答
我如何设置IronPDFEngine进行远程PDF生成？
要设置IronPDFEngine进行远程PDF生成，请从NuGet安装IronPdf.Slim包，并使用IronPDFConnectionConfiguration类配置连接设置。此设置允许您将应用程序远程连接到IronPDFEngine实例。
使用IronPDFEngine与我的应用程序的主要好处是什么？
在应用程序中使用IronPDFEngine可以远程执行PDF任务，帮助避免平台特定的兼容性问题，特别是在旧系统和移动平台上。此外，它在执行期间不需要.NET运行时。
为什么我可能选择使用IronPDFEngine而不是本地PDF库？
您可能选择使用IronPDFEngine来远程运行性能密集型的PDF功能，减少与不同操作系统的兼容性问题，并通过利用与Chrome相同的渲染器提高HTML到PDF转换的性能。
IronPDFEngine支持水平扩展吗？
不，IronPDFEngine目前不支持水平扩展，这意味着由于服务器内存中PDF文件二进制文件的处理方式，它无法负载均衡到多个实例。
IronPDFEngine可以在不同操作系统上运行吗？
IronPDFEngine设计用于使用Docker容器在Linux系统上运行。然而，二进制文件是平台特定的，因此您需要确保使用适合您操作系统的版本。
如果使用IronPDFEngine时我的PDF输出不同，我该怎么办？
由于不同操作系统的行为，PDF输出可能会略有不同。为了减少差异，请确保您使用正确的Docker镜像，并检查可能影响渲染的任何操作系统特定设置。
我如何确保我的应用程序使用正确版本的IronPDFEngine？
为了确保兼容性，每个版本的IronPDF都需要匹配版本的IronPDFEngine。请确保同时更新两个组件，以避免跨版本问题。
在Windows上使用IronPDFEngine有哪些限制？
在Windows上使用IronPDFEngine时，您需要Linux Containers for Docker，并必须确保服务器端口可访问。二进制文件是平台特定的，需要切换到Linux Containers。
如何配置IronPDF以连接到远程IronPDFEngine服务器？
要为远程服务器配置IronPDF，请使用Installation.ConnectToIronPDFHost方法中的IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer，指定服务器的IP和端口详细信息。
使用IronPDFEngine时应该使用哪个包以最小化应用程序大小？
您应使用NuGet中的IronPdf.Slim包，因为它仅包含运行IronPDF与IronPDFEngine所需的组件，从而减少应用程序大小。
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
