如何使用 C# 在 IronPDF 中使用渲染选项

如何在 IronPDF 中使用渲染选项？ 虽然许多渲染选项属性是为 HTML 到 PDF 的转换而设计的，但它们也适用于其他 PDF 转换类型。 让我们将 Markdown 渲染成 PDF，并使用渲染选项配置输出。 具体到 HTML 转换，请了解将 HTML 文件转换为 PDF 或将 HTML 字符串转换为 PDF。

为什么要配置渲染选项？ 配置渲染选项可确保生成的 PDF 符合准确的规格：自定义纸张尺寸、特定页边、页眉和页脚，或启用 JavaScript 以生成动态内容。 在为专业文档或报告创建新的 PDF 时，这种控制至关重要。

当我应用多个渲染选项时会发生什么？ 多种渲染选项协同工作，以创建最终的 PDF 输出。 每个选项都会修改特定的渲染方面，IronPDF 在转换过程中会依次应用这些选项。 例如，在同时设置页边距和页眉时，除非使用 `UseMarginsOnHeaderAndFooter` 属性重载，否则页眉内容将尊重页边距设置。 <！--说明：说明代码概念的图表或截图 --> ```csharp :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ``` ### 高级渲染选项示例 本综合示例演示了如何结合多种渲染选项生成专业文档。 当您需要[添加页眉和页脚](https://ironpdf.com/how-to/headers-and-footers/)或使用[自定义纸张尺寸](https://ironpdf.com/how-to/custom-paper-size/)时，这种方法会有所帮助： ```csharp using IronPdf; using IronPdf.Rendering; // Create renderer with advanced options var renderer = new ChromePdfRenderer(); // Configure paper and layout settings renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait; renderer.RenderingOptions.PaperSize = PdfPaperSize.A4; renderer.RenderingOptions.PrintHtmlBackgrounds = true; // Set margins for professional layout renderer.RenderingOptions.MarginTop = 40; // mm renderer.RenderingOptions.MarginBottom = 40; // mm renderer.RenderingOptions.MarginLeft = 20; // mm renderer.RenderingOptions.MarginRight = 20; // mm // Enable JavaScript for dynamic content renderer.RenderingOptions.EnableJavaScript = true; renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 seconds for JS to execute // Add professional header with page numbers renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter { Height = 25, HtmlFragment = @"

Document Title - Page {page} of {total-pages}

", DrawDividerLine = true }; // Add footer with timestamp renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter { Height = 20, HtmlFragment = @"

Generated on {date} at {time}

" }; // Render HTML content string htmlContent = @"

This document demonstrates advanced rendering options.

"; PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("professional-document.pdf"); ```

---

有哪些可用的渲染选项？ 高级选项可定义 PDF 渲染设置，如边距、纸张方向、纸张大小等。 当您需要设置自定义边距或使用不同的视口设置和缩放级别时，了解这些选项会有所帮助。

哪些渲染选项最常用？ 最常用的渲染选项包括页边距设置、纸张大小配置、页眉/页脚设置和启用 JavaScript。 这些选项涵盖了大多数 PDF 定制需求。 对于基于网络的内容，JavaScript 渲染选项可确保动态元素的正确渲染。

如何选择正确的渲染选项？ 根据您的要求选择渲染选项：打印布局使用页边距设置，动态网页内容启用 JavaScript，专业文档配置页眉/页脚，特定输出格式调整纸张大小。 在处理网页内容时，应考虑 CSS 媒体类型，以获得最佳渲染效果。

何时应使用高级渲染选项？ 在使用自定义 CSS 注入、LaTeX 数学渲染、灰度输出等专业功能时，或在处理需要特定 JavaScript 执行时间的复杂网络应用程序时，请使用高级渲染选项。 WaitFor 类可精确控制复杂场景下的渲染延迟。 ### 使用表单元素 当 HTML 包含表单元素时，IronPDF 会自动将其转换为交互式 PDF 表单： ```csharp using IronPdf; var renderer = new ChromePdfRenderer(); // Enable PDF form creation from HTML forms renderer.RenderingOptions.CreatePdfFormsFromHtml = true; // HTML with form elements string formHtml = @"

Name:
Email:
Subscribe:
Submit

"; PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml); pdfWithForms.SaveAs("interactive-form.pdf"); ``` 下表说明了可用的不同选项。

类别	ChromePdfRenderer
说明	用于定义 PDF 打印输出选项，如纸张大小、DPI、页眉和页脚
属性/功能	翻译类型	说明
`CustomCookies`	`Dictionary<string, string>`	用于 HTML 渲染的自定义 Cookie。Cookie 不会在两次渲染之间持续存在，每次都必须设置。
`PaperFit`	`VirtualPaperLayoutManager`	A manager for setting up virtual paper layouts, controlling how content will be laid out on PDF "paper" pages. Includes options for Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups.
`UseMarginsOnHeaderAndFooter`	`UseMargins`	在呈现页眉和页脚时，使用主文档中的页边距值。
`CreatePdfFormsFromHtml`	`bool`	将所有 HTML 表单元素转化为可编辑的 PDF 表单。默认值为 true。
`CssMedia翻译类型`	`PdfCssMedia翻译类型`	启用 Media="screen" CSS 样式和样式表。默认值为 PdfCssMedia翻译类型.Screen。
`CustomCssUrl`	`string`	允许在渲染前将自定义 CSS 样式表应用于 HTML。可以是本地文件路径或远程 URL。仅适用于将 HTML 呈现为 PDF 时。
`EnableJavaScript`	`bool`	使 JavaScript 和 JSON 能够在页面呈现之前执行。非常适合从 Ajax / Angular 应用程序中打印。默认值为 false。
`EnableMathematicalLaTex`	`bool`	实现数学 LaTeX 元素的渲染。
`Javascript`	`string`	在加载所有 HTML 之后、PDF 呈现之前执行自定义 JavaScript 字符串。
`JavascriptMessageListener`	`StringDelegate`	浏览器 JavaScript 控制台消息可用时调用的方法回调。
`FirstPageNumber`	`int`	在 PDF 页眉和页脚中使用的第一个页码。默认值为 1。
`TableOfContents`	`TableOfContents翻译类型s`	在 HTML 文档中找到 id 为 "ironPdf-toc "元素的位置生成目录。
`GrayScale`	`bool`	输出黑白 PDF。默认值为假。
`TextHeader`	`ITextHeaderFooter`	将每个 PDF 页面的页脚内容设置为文本，支持 "邮件合并 "并自动将 URL 转变为超链接。
`TextFooter`
`HtmlHeader`	`HtmlHeaderFooter`	将每个 PDF 页面的页眉内容设置为 HTML。支持 "邮件合并"。
`HtmlFooter`
`InputEncoding`	`Encoding`	输入字符编码字符串。默认值为 Encoding.UTF8。
`MarginTop`	`double`	PDF 顶部 "纸张 "页边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
`MarginRight`	`double`	PDF 右 "纸 "边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
`MarginBottom`	`double`	PDF 底部 "纸张 "页边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
`MarginLeft`	`double`	PDF 左 "纸 "边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
`PaperOrientation`	`PdfPaperOrientation`	PDF 纸张方向，如纵向或横向。默认值为纵向。
`PaperSize`	`PdfPaperSize`	设置纸张大小
`SetCustomPaperSizeinCentimeters`	`double`	以厘米为单位设置纸张大小。
`SetCustomPaperSizeInInches`		以英寸为单位设置纸张大小。
`SetCustomPaperSizeinMilimeters`		以毫米为单位设置纸张大小。
`SetCustomPaperSizeinPixelsOrPoints`		以屏幕像素或打印机点为单位设置纸张大小。
`PrintHtmlBackgrounds`	`Boolean`	表示是否从 HTML 打印背景颜色和图像。默认值为 true。
`RequestContext`	`RequestContexts`	请求为该译文提供上下文，确定某些资源（如 cookie）的隔离。
`Timeout`	`Integer`	渲染超时（秒）。默认值为 60。
`Title`	`String`	PDF 文档名称和标题元数据，对 IronPdf MVC 和 Razor 扩展中的邮件合并和自动文件命名非常有用。
`ForcePaperSize`	`Boolean`	在从 HTML 生成 PDF 后，通过调整页面大小，强制页面大小与通过 IronPDF.ChromePdfRenderOptions.PaperSize 指定的完全一致。在将 HTML 渲染为 PDF 时，帮助纠正页面大小的微小错误。
`WaitFor`	`WaitFor`	一个封装对象，用于保存等待机制的配置，以便用户在呈现之前等待特定事件。默认情况下，它不会等待任何事件。

准备好探索更多功能了吗？ 请访问我们的教程页面：[Convert PDFs](https://ironpdf.com/tutorials/convert-pdf/)