如何在 C# 中将 HTML 字符串转换为 PDF；

IronPdf 使用 Chrome 浏览器渲染引擎，用 C# 将 HTML 字符串转换为 PDF 文档，支持所有 HTML5、CSS3 和 JavaScript 内容，只需一行代码即可完成基本转换。 该库为 创建 PDF 提供了强大的功能，同时保持了完美的渲染保真度。

IronPDF允许开发者在.NET Core和.NET Framework的C#、F#和VB.NET中轻松创建PDF文档。 IronPdf 支持将任何 HTML 字符串渲染为 PDF，渲染过程使用功能齐全的谷歌 Chromium 引擎版本。这确保了 HTML 内容在现代网络浏览器中的显示效果，使其成为从动态 HTML 内容生成报告、发票和文档的理想选择。

<! -- 待办事项：在此处添加图片 --> <! -- --> <！--说明：说明代码概念的图表或截图 -->

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

使用 IronPDF 将 HTML 字符串转换为 PDF 文件。 本指南演示了如何用最少的代码在 C# 中将 HTML 字符串转换为 PDF 文档。 非常适合需要将 PDF 渲染功能集成到其项目中的开发人员。

最小工作流程（5 个步骤）

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

如何将简单的 HTML 字符串转换为 PDF？ 下面是 IronPDF 使用 `RenderHtmlAsPdf` 方法将 HTML 字符串渲染为 PDF 的示例。 参数是要渲染为PDF的HTML字符串。 该方法是`ChromePdfRenderer`类的一部分，该类提供了对[渲染选项](https://ironpdf.com/how-to/rendering-options/)的广泛控制，可满足您的 PDF 生成需求。 --> <！--说明：说明代码概念的图表或截图 --> ```csharp :path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf.cs ``` `RenderHtmlAsPdf`方法返回一个`PdfDocument`对象，这是一个用于保存PDF信息的类。 该对象提供了许多操作 PDF 的方法，包括 [合并 PDF](https://ironpdf.com/how-to/merge-or-split-pdfs/)、[添加水印](https://ironpdf.com/how-to/custom-watermark/)和 [设置安全选项](https://ironpdf.com/how-to/pdf-permissions-passwords/)。 当从外部源获取 HTML 字符串，并需要禁止本地磁盘访问或跨源请求时，请将 `ChromePdfRenderer.EnableWebSecurity` 属性设置为 true。 对于包含 CSS 样式的复杂 HTML 内容，请使用 [Base URLs & Asset Encoding](https://ironpdf.com/how-to/base-urls/) 功能通过内联样式或引用外部样式表来增强 HTML 字符串： ```csharp // Example with inline CSS var styledHtml = @"

This PDF was generated from HTML with custom styling.

"; var styledPdf = renderer.RenderHtmlAsPdf(styledHtml); styledPdf.SaveAs("styled-output.pdf"); ```

生成的 PDF 看起来像什么？ 这是代码生成的文件： 生成的 PDF 将保持 HTML 的准确格式和样式，因此非常适合 [ 生成 PDF 报告](https://ironpdf.com/how-to/csharp-pdf-reports/)或将网页内容转换为可打印的文档。

在将 HTML 转换为 PDF 时如何包含外部资产？ 本例显示 IronPDF 从可选的 BasePath 加载外部图像资产。 设置BaseUrlOrPath属性提供了超链接、图像、CSS和JavaScript文件的相对文件路径或URL上下文。 在处理 PDF 中的 [ 图像](https://ironpdf.com/how-to/add-images-to-pdfs/)或需要引用外部资源时，此功能至关重要。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf-2.cs ``` 对于涉及复杂布局或动态内容的高级场景，请利用 IronPDF 对 [JavaScript 渲染](https://ironpdf.com/how-to/javascript-to-pdf/)的支持： ```csharp // Example with JavaScript-generated content var jsHtml = @"

"; // Configure rendering to wait for JavaScript execution renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds var dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, @"C:\site\"); dynamicPdf.SaveAs("dynamic-content.pdf"); ``` 在处理外部资产时，您可能需要处理身份验证或特殊标头。 IronPDF 通过 [HTTP Request Header](https://ironpdf.com/how-to/http-request-header/) 功能提供支持，允许您在获取资源时包含授权令牌或自定义标头。

为什么设置 BasePath 对于外部资源很重要？ 这是代码生成的文件： 正确设置 BasePath 可确保正确解析 HTML 中的所有相对引用。 没有它，IronPDF 就无法定位图片、样式表或脚本等外部资源。这一点在以下情况下尤为重要 1.转换引用本地文件系统资源的 HTML 2.使用相对 URL 的内容管理系统 3.将现有网页内容转换为 PDF 格式 4.创建使用共享资产的模板 对于基于网络的资源，请使用完整的 URL 作为基本路径： ```csharp // Using a web URL as base path var webBasedPdf = renderer.RenderHtmlAsPdf( "", "https://mywebsite.com" ); ``` 如需对 PDF 生成过程进行更多控制，请浏览 IronPDF 有关 [自定义页边距](https://ironpdf.com/how-to/custom-margins/)、[页面方向](https://ironpdf.com/how-to/page-orientation-rotation/) 和 [PDF压缩](https://ironpdf.com/how-to/pdf-compression/) 的大量文档，以便针对各种使用情况优化您的输出文件。