如何将 HTML 字符串渲染为 PDF

雷根·彭

2023年三月15日

更新 2025年二月11日

Translated

View the article in English

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

开始使用IronPDF

立即在您的项目中开始使用IronPDF，并享受免费试用。

第一步：

如何将 HTML 字符串渲染为 PDF

从 NuGet 下载 IronPDF C# 库
实例化PDF渲染器并传递HTML字符串
为PDF中的外部资产配置BasePath
配置RenderingOptions以微调输出的PDF
保存并下载生成的 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 字符串，并希望禁用本地磁盘访问或跨域请求的情况下，可以将Installation.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

这是代码生成的文件：

雷根·彭

立即与工程团队聊天

软件工程师

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