1. IronPDF
  2. 操作指南
  3. 如何将 HTML 字符串呈现为 PDF
如何在 C# 中将 HTML 字符串呈现为 PDF | IronPDF

How to Convert HTML String to PDF in C#

Regan Pun
Regan Pun
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF允许开发者在.NET Core和.NET Framework的C#、F#和VB.NET中轻松创建PDF文档。 IronPdf支持将任何HTML字符串渲染为PDF，渲染过程由功能齐全的Google Chromium引擎完成。

快速入门：秒级转换HTML字符串为PDF

使用IronPDF轻松将HTML字符串转换为PDF文件。 本指南演示了如何在C#中只需几行代码就快速将HTML字符串转换为PDF文档。 非常适合希望将高效的PDF渲染功能集成到其项目中的开发者。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

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

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小化工作流程（5步）

如何将HTML字符串呈现为C#中的PDF
  1. 从NuGet下载IronPDF C#库
  2. 实例化PDF渲染器并传递HTML字符串
  3. 为PDF中的外部资源配置BasePath
  4. 配置RenderingOptions以微调输出PDF
  5. 保存并下载生成的PDF


HTML字符串到PDF示例

这里是一个IronPDF使用RenderHtmlAsPdf方法将HTML字符串渲染为PDF的示例。 参数是要渲染为PDF的HTML字符串。

:path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Create a PDF from a HTML string using C#
Private pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

' Export to a file or Stream
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

RenderHtmlAsPdf方法返回一个PdfDocument对象，这是一个用于保存PDF信息的类。

在某些情况下，从外部来源获取HTML字符串，并且希望禁用本地磁盘访问或跨域请求，可以将ChromePdfRenderer.EnableWebSecurity属性设置为true来实现。

结果

这是代码生成的文件：

高级HTML到PDF示例

这里是一个IronPDF从可选的BasePath加载外部图像资源的示例。 设置BaseUrlOrPath属性提供了超链接、图像、CSS和JavaScript文件的相对文件路径或URL上下文。

:path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf-2.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Advanced Example with HTML Assets
' Load external html assets: Images, CSS and JavaScript.
' An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
Private myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\site\assets\")
myAdvancedPdf.SaveAs("html-with-assets.pdf")
$vbLabelText   $csharpLabel

这是代码生成的文件：

常见问题解答

如何在 C# 中将 HTML 字符串转换为 PDF 文档？

要在 C# 中转换 HTML 字符串为 PDF，您可以使用 IronPDF 的 StaticRenderHtmlAsPdf 方法，该方法来自 IronPdf.ChromePdfRender 类。此方法接受 HTML 字符串，将其呈现为 PDF，并允许您将其保存为文件。

将 HTML 字符串呈现为 PDF 涉及哪些步骤？

使用 IronPDF 将 HTML 字符串呈现为 PDF 的步骤包括从 NuGet 下载 IronPDF 库、实例化 PDF 渲染器、传递 HTML 字符串、配置渲染选项（如外部资产的 BasePath），并保存生成的 PDF。

我可以在 PDF 中包含外部图像和 CSS 吗？

可以，通过设置 BaseUrlOrPath 属性，IronPDF 允许您在 PDF 中包含外部图像和 CSS。此属性为在呈现 HTML 为 PDF 时加载资源（如图像、CSS 和 JavaScript 文件）提供了上下文。

怎样提高从外部来源呈现 HTML 时的安全性？

为了增强从外部来源呈现 HTML 时的安全性，您可以在 IronPDF 中将 ChromePdfRenderer.EnableWebSecurity 属性设置为 true。这会禁用本地磁盘访问和跨域请求。

设置 IronPDF 中的 BaseUrlOrPath 属性有什么目的？

BaseUrlOrPath 属性用于定义加载外部资源（如图像、CSS 和 JavaScript 文件）的基路径或 URL 上下文。它确保在呈现 HTML 为 PDF 时正确引用这些资源。

在 IronPDF 中用于保存已呈现 PDF 的方法是什么？

使用 IronPDF 将 HTML 字符串呈现为 PDF 后，您可以通过在 PdfDocument 对象上调用 SaveAs 方法，指定所需的文件路径来保存 PDF。

我在哪里可以下载 IronPDF 库？

您可以从 NuGet 下载 IronPDF C# 库。为此，请访问 NuGet 网站并搜索 IronPDF 以找到该包。

如何将具有外部资源的 HTML 字符串呈现为 PDF？

IronPDF 允许通过设置 BaseUrlOrPath 属性来呈现包含外部资源的 HTML。您可以从指定的 URL 或路径加载图像、CSS 和 JavaScript 并将它们呈现到 PDF 中。

IronPDF 与 .NET 10 兼容吗？

是的——IronPDF 完全支持 .NET 10，以及 .NET 9、8、7、6 和 .NET Core。它无需任何特殊配置即可在 .NET 10 项目中开箱即用。支持的平台包括 Windows、Linux、macOS 和容器化环境。

Regan Pun
Regan Pun
  立即与工程团队聊天
软件工程师
Regan 毕业于雷丁大学，获得电子工程学士学位。在加入 Iron Software 之前，之前的工作角色让他专注于单一任务；他最喜欢 Iron Software 的是他可以承担的各种工作，无论是增加销售价值、技术支持、产品开发还是市场营销。他喜欢了解开发人员如何使用 Iron Software 库，并利用这些知识不断改进文档和开发产品。
准备开始了吗？
Nuget 下载 16,133,208 | 版本: 2025.11 刚刚发布