1. IronPDF
  2. 操作指南
  3. 渲染選項

在這頁

How to Use the Rendering Options

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/article_date_line.php

Line Number: 60

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/article_date_line.php
Line: 60
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 52
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

更新日期:
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 IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
    .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
    .SaveAs("renderingOptions.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小工作流程（5 步）

  1. 下載 C# 庫以使用渲染選項
  2. 準備要轉換為 PDF 文件的 HTML 資源或文件
  3. 實例化 ChromePdfRenderer 類以渲染 PDF
  4. 直接訪問 RenderingOptions 屬性以配置設置
  5. 以所需格式渲染 PDF

## 渲染選項示例 儘管許多渲染選項屬性是專門為 HTML 到 PDF 轉換設計的，但它們也可以用於其他類型的 PDF 轉換。 讓我們將 Markdown 語法渲染為 PDF 並使用渲染選項配置 PDF 輸出。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ```
## 所有渲染選項 我們有一些高級選項來定義 PDF 渲染選項，如調整邊距、紙張方向、紙張大小等等。 下面是一個表格來說明各種不同的選項。
類別ChromePdfRenderer
描述用於定義 PDF 打印輸出選項，如紙張大小、DPI、頁眉和頁腳
屬性/功能類型描述
CustomCookiesDictionary自定義 HTML 渲染的 cookie。cookie 不會在渲染之間持續存在，必須每次設置。
PaperFitVirtualPaperLayoutManager設置虛擬紙張佈局的管理器，控制內容將如何佈局在 PDF "紙張" 頁面上。包括默認 Chrome 行為、縮放、響應式 CSS3 佈局、按比例到頁面和連續輸送樣式 PDF 頁面設置的選項。
UseMarginsOnHeaderAndFooterUseMargins在渲染頁眉和頁腳時使用主文檔的邊距值。
CreatePdfFormsFromHtmlbool將所有 HTML 表單元素轉換為可編輯的 PDF 表單。默認值為 true。
CssMediaTypePdfCssMediaType啟用 Media="screen" CSS 樣式和樣式表。默認值為 PdfCssMediaType.Screen。
CustomCssUrlstring允許在渲染前應用自定義的 CSS 樣式表到 HTML。可以是本地文件路徑或遠程 URL。僅在從 HTML 渲染到 PDF 時適用。
EnableJavaScriptbool在頁面被渲染前允許執行 JavaScript 和 JSON。非常適合從 Ajax / Angular 應用程序打印。默認值為 false。
EnableMathematicalLaTexbool啟用數學 LaTeX 元素的渲染。
Javascriptstring自定義 JavaScript 字符串，在所有 HTML 加載後但在 PDF 渲染前執行。
JavascriptMessageListenerStringDelegate當瀏覽器 JavaScript 控制台消息可用時要調用的方法回調。
FirstPageNumberint用於 PDF 頁眉和頁腳的起始頁碼。默認值為 1。
TableOfContentsTableOfContentsTypes在 HTML 文檔中找到 ID 為 "ironpdf-toc" 的元素的位置生成目錄。
GrayScalebool輸出黑白 PDF。默認值為 false。
TextHeaderITextHeaderFooter為每個 PDF 頁面設置文本頁腳內容，支持“郵件合併”並自動將 URL 轉換為超鏈接。
TextFooter
HtmlHeaderHtmlHeaderFooter為每個 PDF 頁面設置 HTML 頁眉內容。支持“郵件合併”。
HtmlFooter
InputEncodingEncoding作為字符串的輸入字符編碼。默認值為 Encoding.UTF8。
MarginTopdoublePDF "紙張" 上部邊距（單位：毫米）。設置為零可用於無邊框和商業打印應用。默認值為 25。
MarginRightdoublePDF "紙張" 右側邊距（單位：毫米）。設置為零可用於無邊框和商業打印應用。默認值為 25。
MarginBottomdoublePDF "紙張" 底部邊距（單位：毫米）。設置為零可用於無邊框和商業打印應用。默認值為 25。
MarginLeftdoublePDF "紙張" 左側邊距（單位：毫米）。設置為零可用於無邊框和商業打印應用。默認值為 25。
PaperOrientationPdfPaperOrientationPDF 紙張方向，例如縱向或橫向。默認值為縱向。
PaperSizePdfPaperSize設置紙張大小
SetCustomPaperSizeinCentimetersdouble設置紙張大小（單位：厘米）。
SetCustomPaperSizeInInches設置紙張大小（單位：英吋）。
SetCustomPaperSizeinMilimeters設置紙張大小（單位：毫米）。
SetCustomPaperSizeinPixelsOrPoints設置紙張大小（單位：屏幕像素或打印點）。
PrintHtmlBackgroundsBoolean指示是否列印 HTML 的背景顏色和圖像。默認值為 true。
RequestContextRequestContexts針對此渲染的請求上下文，確定某些資源（如 cookie）的隔離。
TimeoutInteger渲染超時（單位：秒）。默認值為 60。
TitleStringPDF 文檔名稱和標題元數據，便於在 IronPdf MVC 和 Razor 擴展中進行郵件合併和自動文件命名。
ForcePaperSizeBoolean強制頁面尺寸要精確按照 IronPdf.ChromePdfRenderOptions.PaperSize 指定的大小，通過在從 HTML 生成 PDF 後調整頁面大小來幫助更正頁面尺寸的小錯誤。
WaitForWaitFor一種包裝對象，持有等待機制的配置，讓用戶能夠等待某些事件完成後再進行渲染。默認情況下，將不等待任何事件。
準備看看您還能做哪些其他事情嗎？ 在這裡查看我們的教程頁面：[轉換PDF](https://ironpdf.com/tutorials/convert-pdf/)

常見問題解答

如何優化IronPDF的PDF渲染效果？

若要使用 IronPDF 最佳化 PDF 渲染，請利用ChromePdfRenderer類別的RenderingOptions屬性。此屬性可讓您自訂設置，例如 JavaScript 執行、表單欄位渲染和自訂紙張尺寸。

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

IronPDF 中的ChromePdfRenderer類別對於 PDF 產生至關重要，因為它提供了各種渲染選項，可以自訂 PDF 的建立方式。它支援紙張尺寸調整、佈局管理和 JavaScript 執行等功能。

我可以使用 IronPDF 從 Markdown 語法產生 PDF 嗎？

是的，IronPDF 支援將 Markdown 語法轉換為 PDF 的渲染選項。這可以透過配置ChromePdfRenderer類別來處理 Markdown 輸入。

如何在 IronPDF 中調整頁邊距和頁首？

在 IronPDF 中，您可以使用ChromePdfRenderer類別中的RenderingOptions屬性來調整頁邊距和頁首。這樣，您可以指定自訂頁邊距，並在 PDF 文件中新增頁首和頁尾。

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

是的，IronPDF 允許透過配置RenderingOptions屬性來輸出灰階影像。此選項有助於減小檔案大小，對於產生便於列印的 PDF 檔案非常有用。

如何在IronPDF中管理頁面佈局樣式？

在 IronPDF 中，您可以使用ChromePdfRenderer類別中的PaperFit管理器來管理紙張佈局樣式。它提供了諸如響應式 CSS3 佈局和連續進紙樣式設定等選項。

IronPDF中有哪些自訂紙張尺寸的選項？

IronPDF 提供了諸如SetCustomPaperSizeinCentimeters 、 SetCustomPaperSizeInInches和SetCustomPaperSizeinMilimeters等方法來定義 PDF 文件的自訂紙張尺寸。

如何在產生PDF時新增自訂CSS？

若要在 IronPDF 中將自訂 CSS 整合到 PDF 產生過程中，請使用CustomCssUrl屬性指定 CSS 檔案的路徑。這樣可以確保樣式在渲染過程中生效。

IronPDF能否根據HTML輸入表單建立可填寫的PDF表單？

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

如何排查PDF渲染中的JavaScript問題？

請確保已啟用 JavaScript，方法是將ChromePdfRenderer類別的RenderingOptions中的EnableJavaScript屬性設為 true。這樣就可以在 PDF 轉換過程中執行腳本。

IronPDF 是否完全相容於 .NET 10？這是否會影響渲染選項？

是的——IronPDF 完全相容於 .NET 10，而這種相容性也延伸到了渲染選項。邊距、CSS 媒體類型、JavaScript 執行和紙張大小等渲染行為在 .NET 10 下與先前的 .NET 8/9 版本完全相同，無需任何特殊配置或功能標誌。

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/author_component.php

Line Number: 18

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 18
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

  立即與工程團隊聊天

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'title'

Filename: sections/author_component.php

Line Number: 38

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 38
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'comment'

Filename: sections/author_component.php

Line Number: 48

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 48
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

準備好開始了嗎？
Nuget 下載 16,154,058 | 版本： 2025.11 剛剛發布