如何在 IronPDF 中使用 C# 渲染選項

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

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, Css媒體類型 = IronPdf.Rendering.PdfCss媒體類型.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", 暫停 = 120000 } }
        .RenderHtml細繩AsPdf("<h1>Hello Options</h1>")
        .SaveAs("renderingOptions.pdf");
  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer


渲染選項範例

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

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

// Instantiate a ChromePdfRenderer object, which uses a headless version of the Chrome browser
// to render HTML/CSS as a PDF document.
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options
// Enable printing of HTML backgrounds to ensure all styles are visible.
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set HTML header content using HtmlHeaderFooter.
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    // HTML fragment to add a header at the top of every page in the PDF.
    HtmlFragment = "<h1>Header Content</h1>"
};

// Set a custom paper size for the PDF in millimeters (width and height).
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);

// Set the top margin to zero to start the content from the very top of the page.
renderer.RenderingOptions.MarginTop = 0;

// Define a Markdown string that will be rendered as a PDF.
// Markdown text allows basic formatting like bold and italic styles.
string md = "This is some **bold** and *italic* text.";

// Render the Markdown string to a PDF document.
// The library will convert Markdown syntax into equivalent HTML before rendering it as a PDF.
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the generated PDF to a file named "renderingOptions.pdf."
pdf.SaveAs("renderingOptions.pdf");
Imports IronPdf

' Instantiate a ChromePdfRenderer object, which uses a headless version of the Chrome browser
' to render HTML/CSS as a PDF document.
Private renderer As New ChromePdfRenderer()

' Configure rendering options
' Enable printing of HTML backgrounds to ensure all styles are visible.
renderer.RenderingOptions.PrintHtmlBackgrounds = True

' Set HTML header content using HtmlHeaderFooter.
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = "<h1>Header Content</h1>"}

' Set a custom paper size for the PDF in millimeters (width and height).
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150)

' Set the top margin to zero to start the content from the very top of the page.
renderer.RenderingOptions.MarginTop = 0

' Define a Markdown string that will be rendered as a PDF.
' Markdown text allows basic formatting like bold and italic styles.
Dim md As String = "This is some **bold** and *italic* text."

' Render the Markdown string to a PDF document.
' The library will convert Markdown syntax into equivalent HTML before rendering it as a PDF.
Dim pdf As PdfDocument = renderer.RenderMarkdownStringAsPdf(md)

' Save the generated PDF to a file named "renderingOptions.pdf."
pdf.SaveAs("renderingOptions.pdf")
$vbLabelText   $csharpLabel

所有渲染選項

我們提供了一些進階選項,可以定義 PDF 渲染選項,例如調整頁邊距、紙張方向、紙張大小等等。

下面這張表格列出了許多不同的選項。

班級 ChromePdfRenderer
描述 用於定義 PDF 列印輸出選項,例如紙張尺寸、DPI、頁首和頁尾。
屬性/功能 類型 描述
CustomCookies Dictionary<細繩, 細繩> 用於 HTML 渲染的自訂 Cookie。 Cookie 不會在渲染之間保留,每次渲染都必須重新設定。
PaperFit 虛擬紙張佈局管理器 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.
使用頁首和頁尾的邊距 使用邊距 渲染頁首和頁尾時,使用文件主文檔的邊距值。
CreatePdfFormsFromHtml 布林值 將所有 HTML 表單元素轉換為可編輯的 PDF 表單。預設值為 true。
Css媒體類型 PdfCss媒體類型 啟用 Media="screen" CSS 樣式和樣式表。預設值為 PdfCss媒體類型.Screen。
自訂CssURL 細繩 允許在渲染 HTML 之前將自訂 CSS 樣式表套用至 HTML。可以是本機檔案路徑或遠端 URL。僅適用於將 HTML 渲染為 PDF 的情況。
啟用 JavaScript 布林值 允許在頁面渲染之前執行 JavaScript 和 JSON 程式碼。非常適合從 Ajax/Angular 應用程式進行列印。預設值為 false。
啟用 MathematicalLaTeX 布林值 啟用數學 LaTeX 元素的渲染。
Javascript 細繩 在所有 HTML 載入完畢後、PDF 渲染之前執行的自訂 JavaScript 字串。
JavascriptMessageListener 細繩Delegate 當瀏覽器 JavaScript 控制台訊息可用時,將呼叫該方法回呼。
首頁頁碼 int PDF頁首和頁尾中使用的起始頁碼。預設值為1。
目錄 目錄類型 在 HTML 文件中找到 id 為"ironpdf-toc"的元素的位置產生目錄。
灰階 布林值 輸出黑白PDF檔。預設值為false。
TextHeader ITextHeaderFooter 將每個 PDF 頁面的頁腳內容設定為文本,支援"郵件合併",並自動將 URL 轉換為超連結。
TextFooter
HtmlHeader HtmlHeaderFooter 將每個 PDF 頁面的頁首內容設定為 HTML 格式。支援郵件合併。
HTML頁腳
輸入編碼 編碼 輸入字元編碼(字串形式)。預設值為 編碼.UTF8。
MarginTop double PDF檔案頂部"紙張"邊距,單位為毫米。設定為零適用於無邊距PDF和商業印刷應用。預設值為25毫米。
MarginRight double PDF右側"紙張"邊距,單位為毫米。設定為零適用於無邊距和商業印刷應用。預設值為25。
MarginBottom double PDF檔案底部"紙張"邊距,單位為毫米。設定為零適用於無邊距PDF和商業印刷應用。預設值為25毫米。
MarginLeft double PDF左側"紙張"邊距,單位為毫米。設定為零適用於無邊距和商業印刷應用。預設值為25。
PaperOrientation PdfPaperOrientation PDF 紙張方向,例如縱向或橫向。預設值為縱向。
紙張尺寸 Pdf紙張尺寸 設定紙張尺寸
設定自訂紙張尺寸(公分) double 設定紙張尺寸(單位:公分)。
設定自訂紙張尺寸(英吋) 設定紙張尺寸(英吋)。
設定自訂紙張尺寸(毫米) 設定紙張尺寸(單位:毫米)。
設定自訂紙張尺寸(像素或磅) 設定紙張尺寸,單位為螢幕像素或印表機點。
PrintHtmlBackgrounds 布林值 指示是否從 HTML 列印背景顏色和圖像。預設值為 true。
RequestContext 請求上下文 請求此渲染的上下文,確定某些資源(例如 cookie)的隔離情況。
暫停 整數 渲染超時時間(秒)。預設值為 60。
標題 細繩 PDF 文件名稱和標題元數據,可用於 IronPdf MVC 和 Razor 擴充功能中的郵件合併和自動文件命名。
紙張尺寸 布林值 透過從 HTML 產生 PDF 後調整頁面大小,強制頁面尺寸與 IronPdf.ChromePdfRenderOptions.紙張尺寸 指定的尺寸完全一致。這有助於修正將 HTML 渲染為 PDF 時頁面尺寸的細微誤差。
等待 等待 一個包裝對象,用於保存等待機制的配置,允許使用者在渲染之前等待特定事件的發生。預設情況下,它不會等待任何事件。

準備好看看您還能做些什麼嗎? 請造訪我們的教學頁面:轉換 PDF 文件

常見問題解答

如何使用 IronPDF 優化 PDF 渲染效果?

要使用 IronPDF 優化 PDF 渲染,請利用 ChromePdfRenderer 類的 RenderingOptions 屬性。這可讓您自訂 JavaScript 執行、表單欄位渲染和自訂紙張大小等設定。

ChromePdfRenderer 類別在 PDF 生成中扮演什麼角色?

IronPDF 中的 ChromePdfRenderer 類是 PDF 生成不可或缺的部分,因為它提供了各種渲染選項來定制 PDF 的創建方式。它支援紙張大小調整、版面管理和 JavaScript 執行等功能。

我可以用 IronPDF 從 Markdown 語法生成 PDF 嗎?

是的,IronPDF 支持渲染选项,允许您将 Markdown 语法转换为 PDF。這可以透過設定 ChromePdfRenderer 類來處理 Markdown 輸入。

如何在 IronPDF 中調整頁邊空白和頁眉?

利用 ChromePdfRenderer 類別中的 RenderingOptions 屬性來調整 IronPdf 中的邊距和標題。這允許您在 PDF 文件中指定自定義頁邊、添加頁首和頁尾。

是否可以在 PDF 渲染中啟用灰階輸出?

是的,IronPDF 允許透過設定 RenderingOptions 屬性進行灰階輸出。此選項有助於減少檔案大小,對於友善列印的 PDF 生成非常有用。

如何在 IronPDF 中管理紙張排版樣式?

在 IronPDF 中,您可以使用 ChromePdfRenderer 類別中的 PaperFit 管理器來管理紙張排版樣式。這提供了一些選項,像是 Responsive CSS3 Layouts 和 Continuous Feed 風格設定。

IronPDF 中有哪些自定義紙張大小的選項?

IronPdf 提供了一些方法,如 SetCustomPaperSizeinCentimeters, SetCustomPaperSizeInInches, 和 SetCustomPaperSizeinMilimeters 來定義自定義 PDF 文件的紙張大小。

如何在生成 PDF 時加入自訂 CSS?

若要在 IronPDF 生成 PDF 的過程中加入自訂 CSS,請使用 CustomCssUrl 屬性指定您的 CSS 檔案路徑。這可確保您的樣式在渲染過程中被套用。

IronPDF 可以從 HTML 輸入表單中建立可填寫的 PDF 表單嗎?

是的,IronPDF 可以透過啟用 RenderingOptions 中的 CreatePdfFormsFromHtml 屬性,從 HTML 輸入建立可填寫的 PDF 表單。此功能對於開發互動式 PDF 非常有用。

如何排除 PDF 渲染中的 JavaScript 問題?

ChromePdfRenderer 類別的 RenderingOptions 中將 EnableJavaScript 屬性設定為 true,以確保 JavaScript 已啟用。這允許腳本在 PDF 轉換過程中執行。

IronPDF 是否與 .NET 10 完全相容,是否會影響渲染選項?

是的 - IronPDF 與 .NET 10 完全相容,這種相容性延伸至渲染選項。在 .NET 10 下,邊界、CSS 媒體類型、JavaScript 執行和紙張大小等渲染行為與之前的 .NET 8/9 版本相同,無需特殊配置或功能標誌。

Chaknith Bin
軟體工程師
Chaknith 在 IronXL 和 IronBarcode 上工作。他對 C# 和 .NET 擁有深厚的專業知識,幫助改進了軟體並支持客戶。他從用戶互動中得到的見解有助於改善產品、文檔和整體體驗。
準備好開始了嗎?
Nuget 下載 16,493,056 | Version: 2025.11 剛發表