如何在 C# 中設置自定義邊距

如何在 IronPDF C# 中設定自訂邊距#。

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

IronPDF 可讓開發人員在從 HTML 渲染 PDF 時,透過 ChromePdfRendererRenderingOptions 的簡單設定來設定自訂邊距,允許以毫米為單位精確控制上、下、左、右邊距。

快速入門:使用 IronPDF 實施自訂 PDF 頁邊

透過簡單的設定,在從 HTML 呈現 PDF 時設定自訂邊距。

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

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

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10, UseMarginsOnHeaderAndFooter = true } }
        .RenderHtmlAsPdf("<h1>Hello with margins!</h1>")
        .SaveAs("custom-margins.pdf");
  3. 部署到您的生產環境進行測試

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

最小工作流程(5 個步驟):

1.從 NuGet 下載 IronPDF。 2.實體化 ChromePdfRenderer 類別 3.在 RenderingOptions 中設定邊緣值 4.設定頁首和頁尾頁邊空白行為 5.將 HTML 渲染成 PDF 並儲存

如何在 IronPDF 中設定自訂 PDF 邊界? <!--說明:說明程式碼概念的圖表或截圖 --> 若要設定自訂頁邊空白,請實體化 `ChromePdfRenderer` 類別。 存取 `RenderingOptions` 物件,以毫米為單位設定上、下、左、右的特定頁邊距: ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins.cs ``` 邊界設定可與 IronPDF 的 [Chrome 渲染引擎](https://ironpdf.com/how-to/ironpdf-2021-chrome-rendering-engine-eap/)配合使用,提供精確的 HTML 至 PDF 轉換。 如需進階 PDF 生成設定,請參閱 [ 渲染選項](https://ironpdf.com/how-to/rendering-options/) 指南。

邊界如何與 CSS 樣式互動? 邊界添加至 HTML `style` 部分中設定的邊界。 在下面的範例中,HTML 頁邊距為 50mm,而 `RenderingOptions` 則增加了 30mm,因此總頁邊距為 80mm: ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins-with-css.cs ``` <!--說明:顯示程式碼執行輸出或結果的截圖 --> 產生的PDF文件如下所示: 在處理 HTML 文件中的 CSS 時,IronPDF 支援 [responsive CSS 和 media queries](https://ironpdf.com/how-to/html-to-pdf-responsive-css/),可進行專業的佈局。 在將 [HTML 檔案轉換為 PDF](https://ironpdf.com/how-to/html-file-to-pdf/) 或處理 [HTML 字串](https://ironpdf.com/how-to/html-string-to-pdf/)時,此邊緣行為很重要。

不同標準的常用邊界值是多少? 文件通常需要特定的頁邊,以符合各種標準。 MLA 和 APA 格式要求 1 英寸頁邊,而論文可能需要 1.5 英寸頁邊。 常用的邊界標準和毫米等值: - **MLA/APA格式**:四邊均為1英寸(25.4毫米 - **論文格式**:四邊均為 1.5 英吋(38.1 公釐 - **商業信函**:邊長 1 英吋,上/下長 2 英吋 (50.8 公釐) - **歐洲 A4 標準**:各邊均為 20mm - **窄邊距**:四邊均為 0.5 英吋 (12.7 公釐) 實施這些標準時,IronPDF 支援 [自訂紙張尺寸](https://ironpdf.com/how-to/custom-paper-size/),允許符合特定區域或組織要求的文件。

如何在頁首和頁尾套用自訂邊界? --> <!--說明:顯示程式碼執行輸出或結果的截圖 --> 根據預設,在 `RenderingOptions` 中設定的頁邊空白不適用於頁首和頁尾。 若要在頁首和頁尾套用文件邊界,請設定 `UseMarginsOnHeaderAndFooter` 屬性: ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-margins-header-footer.cs ``` 有關具有動態內容和樣式的頁首和頁尾實作,請參閱 [ 加入頁首和頁尾](https://ironpdf.com/how-to/headers-and-footers/)的指南。

我該如何選擇性地將邊界套用到頁首和頁尾呢? 指定哪些頁邊適用於頁首和頁尾。 詳細設定請參閱 [API Reference](/object-reference/api/IronPdf.UseMargins.html) 。 範例: ```csharp :path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-specific-margins-header-footer.cs ```

何時應該使用不同的頁首/頁尾邊界配置? 頁首和頁尾的選擇性頁邊配置對於具有非對稱佈局的文件非常有效,例如具有交替頁邊的書籍,或頁首延伸至頁面邊緣而正文內容保持頁邊的書籍。 常見用例: - **書籍出版**:交替內頁邊距/外頁邊距進行裝訂 - **信頭文件**:具有受約束正文的全寬標題 - **表格與範本**:欄位與指示的邊距不同 - **多欄式佈局**:具有欄邊距的全寬標題 ## 進階保證金注意事項 ### 使用分頁符和邊距工作 自訂頁邊與 [ 分頁符](https://ironpdf.com/how-to/html-to-pdf-page-breaks/)互動。 IronPDF 可處理頁面間的內容流程,同時尊重頁邊距的設定,確保多頁文件格式一致。 ### 邊界單位和精確度 IronPdf 使用毫米作為頁邊。 從其他單位轉換: - 英吋轉毫米:乘以 25.4 - 點到毫米:乘以 0.352778 - 像素到毫米:依 DPI 而異 (96 DPI 時,乘以 0.264583) IronPDF 在需要時支援小數值,以達到毫米以下的精確度。 ### 利用邊際利潤優化效能 適用於有自訂頁邊的大型文件: 1.在`渲染器`層級設定一次邊距 2.在類似文件中使用一致的值 3.結合 margin 設定與其他 [ 渲染選項](https://ironpdf.com/how-to/rendering-options/)。 ### 與其他 IronPDF 功能整合。 自訂頁邊與其他 IronPDF 功能搭配使用: - [水印和郵票](https://ironpdf.com/how-to/custom-watermark/)尊重邊界 - [IronPDF壓縮](https://ironpdf.com/how-to/pdf-compression/)保持完整性 - [數位簽名](https://ironpdf.com/how-to/signing/)相對於頁邊的位置 ## 結論 在 IronPDF 中設定自訂頁邊,可精確控制 PDF 排版與格式。 無論是建立商業文件、學術論文或客製化報告,IronPDF 的邊界系統都能確保 PDF 符合精確的規格。 探索 [說明文件](https://ironpdf.com/docs/),瞭解 IronPDF 如何簡化您的 PDF 生成工作流程。

常見問題解答

如何在 C# 中為 PDF 設定自訂頁邊空白?

使用 IronPDF,您可以通過配置 ChromePdfRenderer 的 RenderingOptions 來設置自定邊距。只需以毫米為單位設置 MarginTop、MarginBottom、MarginLeft 和 MarginRight 屬性即可。例如: new ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10 }。}.

邊際測量使用什麼單位?

IronPDF 使用毫米 (mm) 作為 RenderingOptions 中所有頁邊距設定的單位。這提供了對 PDF 排版的精確控制,並確保不同文件標準的一致性。

IronPDF 頁邊與 HTML 中的 CSS 頁邊如何互動?

IronPDF 的頁邊與您 HTML 中定義的 CSS 頁邊相加。如果您的 HTML 邊距為 50mm,而您在 RenderingOptions 中設定為 30mm,則最終 PDF 的總邊距將為 80mm。這可讓您靈活控制間距,同時保留 HTML 的樣式。

我可以在頁首和頁尾套用頁邊距嗎?

是的,IronPDF 在 RenderingOptions 中提供了 UseMarginsOnHeaderAndFooter 屬性。將此設定為 true 會將您自訂的邊距套用至頁首與頁尾,確保整個 PDF 文件的間距一致。

學術格式的建議頁邊空白值是多少?

對於使用 IronPdf 的學術文件,MLA/APA 格式使用 25.4mm(1 英寸),論文使用 38.1mm(1.5 英寸),或歐洲 A4 標準使用 20mm。這些值可以透過 MarginTop、MarginBottom、MarginLeft 和 MarginRight 屬性輕鬆設定。

Chrome 的渲染引擎是否會影響保證金的準確性?

IronPDF 的 Chrome 渲染引擎可確保高度精確的邊界渲染,符合現代網路標準。這可在將 HTML 轉換為 PDF 時提供一致的結果,保持 RenderingOptions 中定義的精確間距。

我可以為 PDF 的每一面設定不同的頁邊空白嗎?

絕對可以。IronPDF 允許透過不同的屬性來獨立控制所有四種頁邊:MarginTop, MarginBottom, MarginLeft 和 MarginRight。這可讓不對稱的版面,例如上/下邊距較大的商業信函。

如何實現窄邊界以獲得最大的內容區域?

若要在 IronPDF 中使用窄邊界,請在 RenderingOptions 中將所有邊界值設定為 12.7 公釐(0.5 英吋)。這樣既能最大化可列印區域,又能保持專業的外觀:RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }。

喬迪·巴迪亞
軟體工程師
喬迪精通Python、C#和C++,除了在Iron Software運用這些技能外,他還從事遊戲程式設計。他參與產品測試、產品開發和研究等工作,為產品的持續改進做出了巨大貢獻。豐富的經驗讓他始終保持挑戰性和工作熱情,他表示這是他最喜歡在Iron Software工作的原因之一。喬迪在佛羅裡達州邁阿密長大,畢業於佛羅裡達大學,主修電腦科學和統計學。
準備好開始了嗎?
Nuget 下載 17,012,929 | 版本: 2025.12 剛剛發布