如何使用渲染選項

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 佈局或連續輸送。


C# NuGet 程式庫用于 PDF

安裝與 NuGet

Install-Package IronPdf
Java PDF JAR

下載 DLL

下載DLL

手動安裝到您的項目中

C# NuGet 程式庫用于 PDF

安裝與 NuGet

Install-Package IronPdf
Java PDF JAR

下載 DLL

下載DLL

手動安裝到您的項目中

立即開始在您的專案中使用IronPDF,並享受免費試用。

第一步:
green arrow pointer

查看 IronPDFNuget 快速安裝和部署。已被下載超過800萬次,它正用C#改變PDF。

C# NuGet 程式庫用于 PDF nuget.org/packages/IronPdf/
Install-Package IronPdf

請考慮安裝 IronPDF DLL 直接下載並手動安裝到您的專案或GAC表單: IronPdf.zip

手動安裝到您的項目中

下載DLL

渲染選項示例

儘管許多渲染選項屬性是專為 HTML 到 PDF 轉換而設計,但它們也可以用於其他類型的 PDF 轉換。 讓我們將 Markdown 語法渲染為 PDF 並使用渲染選項配置 PDF 輸出。

:path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs
using IronPdf;

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

// Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<h1>Header Content</h1>"
};
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);
renderer.RenderingOptions.MarginTop = 0;

// Markdown string
string md = "This is some **bold** and *italic* text.";

// Render from markdown string
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the PDF
pdf.SaveAs("renderingOptions.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer As New ChromePdfRenderer()

' Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = "<h1>Header Content</h1>"}
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150)
renderer.RenderingOptions.MarginTop = 0

' Markdown string
Dim md As String = "This is some **bold** and *italic* text."

' Render from markdown string
Dim pdf As PdfDocument = renderer.RenderMarkdownStringAsPdf(md)

' Save the PDF
pdf.SaveAs("renderingOptions.pdf")
VB   C#

所有渲染選項

我們有一些高級選項,可定義 PDF 渲染選項,如調整邊距,

紙張方向、紙張大小等。

以下是一個表格,用於說明多種不同選項。

類別ChromePdfRenderer
描述用於定義PDF列印選項,例如紙張大小、DPI、頁首和頁尾
屬性 / 函數類型描述
自定義CookiesDictionary<字串, 字串>HTML渲染的自訂Cookie。Cookie不會在渲染之間持續,必須每次都設置。
紙適虛擬紙張佈局管理器一個用於設置虛擬紙張佈局的管理器,控制內容在 PDF「紙張」頁面上的佈局方式。包括默認的 Chrome 行為、縮放、響應式 CSS3 佈局、按頁比例縮放和連續輸送樣式的 PDF 頁面設置選項。
使用頁首和頁腳的邊距使用邊距在渲染頁眉和頁腳時使用主文檔的邊距值。
從Html創建Pdf表單布林值將所有 HTML 表單元素轉換為可編輯的 PDF 表單。默認值為 true。
CssMedia類型PdfCssMedia類型Enables Media="screen" CSS Styles and StyleSheets. Default value is PdfCssMedia類型.Screen.
自訂Css網址字串允許在渲染之前將自定義 CSS 樣式表應用於 HTML。可以是本地檔案路徑或遠端 URL。僅在將 HTML 渲染為 PDF 時適用。
啟用JavaScript布林值在頁面渲染之前允許執行 JavaScript 和 JSON。非常適合從 Ajax / Angular 應用程式列印。預設值為 false。
啟用數學LaTex布林值啟用渲染數學 LaTeX 元素。
JavaScript字串A custom JavaScript 字串 to be executed after all HTML has loaded but before PDF rendering.
JavaScriptMessageListener字串委派當瀏覽器的 JavaScript 控制台訊息變為可用時,將調用的方法回調。
第一頁號碼整數PDF 頁眉和頁腳中使用的第一頁頁碼。預設值為 1。
目錄目錄類型s在 HTML 文件中找到 id 為 "ironpdf-toc" 的元素所在位置生成目錄。
灰度布林值輸出黑白 PDF。預設值為 false。
文本標題I文本標題FooterSets the footer content for every PDF page as text, supporting 'mail-merge' and automatically turning URLs 整數o hyperlinks.
文本頁腳
HtmlHeaderHtmlHeaderFooter將每個 PDF 頁面的標題內容設置為 HTML。支援「郵件合併」。
HtmlFooter
輸入編碼編碼The input character encoding as a 字串. Default value is 編碼.UTF8.
上邊距雙精度Top PDF "paper" margin in millimeters. Set to zero for border-less and commercial pr整數ing applications. Default value is 25.
右邊邊距雙精度Right PDF "paper" margin in millimeters. Set to zero for border-less and commercial pr整數ing applications. Default value is 25.
底邊距雙精度Bottom PDF "paper" margin in millimeters. Set to zero for border-less and commercial pr整數ing applications. Default value is 25.
左邊距雙精度Left PDF "paper" margin in millimeters. Set to zero for border-less and commercial pr整數ing applications. Default value is 25.
紙張方向Pdf紙張方向PDF文件的紙張方向,例如縱向或橫向。默認值為縱向。
紙張大小Pdf紙張大小設定紙張大小
SetCustom紙張大小inCentimeters雙精度設定紙張大小 in centimeters.
SetCustom紙張大小InInches設定紙張大小 in inches.
SetCustom紙張大小inMilimeters設定紙張大小 in millimeters.
SetCustom紙張大小inPixelsOrPo整數s設定紙張大小 in screen pixels or pr整數er po整數s.
Pr整數HtmlBackgrounds布林值Indicates whether to pr整數 background-colors and images from HTML. Default value is 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 工單,並支持產品開發、文件撰寫和行銷,以提升客戶的整體體驗。不在公司時,他通常在學習機器學習、寫程式和徒步旅行。