1. IronPDF
  2. 操作指南
  3. 渲染选项

如何使用渲染选项

This article was translated from English: Does it need improvement?
Translated
View the article in English

由 查克尼特·宾

在 PDF 生成中，渲染选项指的是决定 PDF 文档如何创建、显示和打印的设置和配置。 这些选项可以包括广泛的设置，例如渲染表单字段元素、启用JavaScript、生成目录、添加页眉和页脚、调整边距、设置PDF纸张大小等。

IronPDF 中的 ChromePdfRenderer 类提供了多种渲染选项，使用户可以自定义 PDF 的生成方式。 它包括PaperFit，一个管理器，用于控制内容在PDF页面上的布局，提供不同的布局样式，例如响应式CSS3布局或连续滚动。

如何使用渲染选项

  1. 下载 C# 库以使用渲染选项
  2. 准备要转换为PDF文档的HTML资产或文件
  3. 实例化 ChromePdfRenderer 用于渲染PDF的类
  4. 访问 渲染选项 直接通过属性配置您的设置
  5. 将 PDF 渲染为所需格式

适用于PDF的C# NuGet库

安装使用 NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
或
Java PDF JAR

下载 DLL

下载DLL

手动安装到你的项目中

适用于PDF的C# NuGet库

安装使用 NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
或
Java PDF JAR

下载 DLL

下载DLL

手动安装到你的项目中

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

第一步：
green arrow pointer

查看 IronPDF 上 Nuget 用于快速安装和部署。它有超过800万次下载，正在使用C#改变PDF。

适用于PDF的C# NuGet库 nuget.org/packages/IronPdf/
Install-Package IronPdf

考虑安装 IronPDF DLL 直接。下载并手动安装到您的项目或GAC表单中： IronPdf.zip

手动安装到你的项目中

下载DLL
## 渲染选项示例 尽管许多渲染选项属性是专为HTML到PDF转换设计的，它们也可以用于其他类型的PDF转换。 让我们将Markdown语法渲染为PDF，并使用渲染选项配置PDF输出。 ```cs :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ```
## 所有渲染选项 我们有一些高级选项可以定义PDF呈现选项，例如调整页边距， 纸张方向、纸张尺寸等。 下表展示了多种不同的选项。
班级ChromePdfRenderer
说明用于定义 PDF 打印选项，如纸张大小、DPI、页眉和页脚
属性/功能类型说明
自定义 CookiesDictionary<字符串, 字符串>；用于 HTML 渲染的自定义 Cookie。Cookie 不会在两次渲染之间持续存在，每次都必须设置。
PaperFit虚拟纸张布局管理器这是一款用于设置虚拟纸张布局的管理器，可控制 PDF "纸张 "页面的内容布局。包括默认 Chrome 浏览器行为、缩放、响应式 CSS3 布局、缩放至页面 & 连续进纸式 PDF 页面设置等选项。
在页眉和页脚使用边距使用边距在渲染页眉和页脚时，使用主文档中的页边距值。
从 HTML 创建 PDFFormsFromHtmlbool将所有 HTML 表单元素转化为可编辑的 PDF 表单。默认值为 true。
CssMedia类型PdfCssMedia类型Enables Media="screen" CSS Styles and StyleSheets. Default value is PdfCssMedia类型.Screen.
自定义 CSSUrl字符串允许在呈现之前将自定义 CSS 样式表应用于 HTML。可以是本地文件路径或远程 URL。仅适用于将 HTML 呈现为 PDF 时。
启用 JavaScriptbool可在页面渲染前执行 JavaScript 和 JSON。非常适合从 Ajax / Angular 应用程序打印。默认值为 false。
启用数学语言版本bool启用数学 LaTeX 元素的渲染。
Javascript字符串A custom JavaScript 字符串 to be executed after all HTML has loaded but before PDF rendering.
JavascriptMessageListener字符串Delegate浏览器 JavaScript 控制台消息可用时调用的方法回调。
首页编号intPDF 页眉和页脚中使用的第一个页码。默认值为 1。
目录目录类型s在 HTML 文档中找到 id 为 "ironpdf-toc "元素的位置生成目录。
灰度bool输出黑白 PDF。默认值为假。
文本标题I文本标题Footer将每个 PDF 页面的页脚内容设置为文本，支持 "邮件合并 "并自动将 URL 转变为超链接。
文本页脚
标题标题Footer将每个 PDF 页面的页眉内容设置为 HTML。支持 "邮件合并"。
HtmlFooter
输入编码编码The input character encoding as a 字符串. Default value is 编码.UTF8.
边距顶部双人PDF 顶部 "纸张 "页边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
右边距双人PDF 右 "纸 "边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
底部边距双人PDF 底部 "纸张 "边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
左侧边距双人PDF 左 "纸 "边距，单位为毫米。对于无边框和商业印刷应用，设置为零。默认值为 25。
纸张方向Pdf纸张方向PDF 纸张方向，如纵向或横向。默认值为纵向。
纸张尺寸Pdf纸张尺寸设置纸张大小
SetCustom纸张尺寸inCentimeters双人设置纸张大小 in centimeters.
SetCustom纸张尺寸InInches设置纸张大小 in inches.
SetCustom纸张尺寸inMilimeters设置纸张大小 in millimeters.
SetCustom纸张尺寸inPixelsOrPoints设置纸张大小 in screen pixels or printer points.
打印 HTML 背景布尔型表示是否从 HTML 打印背景颜色和图像。默认值为 true。
请求上下文请求上下文s该呈现的请求上下文，决定某些资源（如 cookie）的隔离。
超时整数渲染超时（秒）。默认值为 60。
标题字符串PDF Document Name and 标题 metadata, useful for mail-merge and automatic file naming in the IronPdf MVC and Razor extensions.
Force纸张尺寸布尔型Force page sizes to be exactly what is specified via IronPdf.ChromePdfRenderOptions.纸张尺寸 by resizing the page after generating a PDF from HTML. Helps correct small errors in page size when rendering HTML to PDF.
等待等待封装对象，用于保存等待机制的配置，以便用户在渲染前等待特定事件。默认情况下，它不会等待任何事件。

查克尼特·宾

软件工程师

Chaknith 是开发者中的福尔摩斯。他第一次意识到自己可能在软件工程方面有前途，是在他出于乐趣做代码挑战的时候。他的重点是 IronXL 和 IronBarcode，但他为能帮助客户解决每一款产品的问题而感到自豪。Chaknith 利用他从直接与客户交谈中获得的知识，帮助进一步改进产品。他的轶事反馈不仅仅局限于 Jira 票据，还支持产品开发、文档编写和市场营销，从而提升客户的整体体验。当他不在办公室时，他可能会在学习机器学习、编程或徒步旅行。