1. IronPDF
  2. 如何
  3. 設定自訂邊距
如何在PDFs C#中設定自訂邊距

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

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF使開發者能夠通過簡單配置RenderingOptions來設定自訂邊界，允許對頁面的上、下、左、右邊界進行精確控製，以毫米為單位。

快速入門：使用IronPDF實現自訂PDF邊界

在從HTML呈現PDF時設置自訂邊界，只需簡單的配置。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/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物件以設置特定的上、下、左、右邊界，單位為毫米：

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 40;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
renderer.RenderingOptions.MarginBottom = 40;
Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40
$vbLabelText   $csharpLabel

邊界設置與IronPDF的Chrome呈現引擎配合使用，提供精確的HTML到PDF轉換。 關於進階PDF生成設置，請參閱呈現選項指南。

邊界如何與CSS樣式互動？

邊界將新增到HTML style部分中設定的邊界。 在下面的例子中，HTML邊界是50毫米，而RenderingOptions新增了30毫米，總邊界為80毫米：

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins-with-css.cs
const string htmlWithStyle = @"
<!DOCTYPE html>
<html>
    <head>
        <style>
            body {margin: 50mm 50mm 50mm 50mm;}
        </style>
    </head>
<body>
    <h1>Hello World!</h1>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginBottom = 30;

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlWithStyle);
pdf.SaveAs("PdfWithCustomMargins.pdf");
Const htmlWithStyle As String = "
<!DOCTYPE html>
<html>
    <head>
        <style>
            body {margin: 50mm 50mm 50mm 50mm;}
        </style>
    </head>
<body>
    <h1>Hello World!</h1>
</body>
</html>"

Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.MarginTop = 30
renderer.RenderingOptions.MarginLeft = 30
renderer.RenderingOptions.MarginRight = 30
renderer.RenderingOptions.MarginBottom = 30

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlWithStyle)
pdf.SaveAs("PdfWithCustomMargins.pdf")
$vbLabelText   $csharpLabel

生成的PDF如下所示：

在HTML文件中使用CSS時，IronPDF支持響應式CSS和媒體查詢，允許專業佈局。 這種邊界行為在將HTML檔案轉換為PDF或處理HTML字串時很重要。

不同標準常見的邊界值有哪些？

文件通常需要特定的邊界以滿足各種標準。 MLA和APA格式需要1英寸邊界，而論文可能需要1.5英寸邊界。

常見的邊界標準及其毫米等值：

  • MLA/APA格式：1英寸（25.4毫米）所有邊
  • 論文格式：1.5英寸（38.1毫米）所有邊
  • 商業信函：1英寸側邊，2英寸（50.8毫米）上/下邊
  • 歐洲A4標準：20毫米所有邊
  • 窄邊：0.5英寸（12.7毫米）所有邊

在實施這些標準時，IronPDF支持自訂紙張尺寸，允許文件達到特定的地區或組織要求。

如何將自訂邊界應用到標題和頁腳？

預設情況下，在RenderingOptions中設置的邊界不應用於標題和頁腳。 要將文件的邊界應用於標題和頁腳，請配置UseMarginsOnHeaderAndFooter屬性：

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-margins-header-footer.cs
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All
$vbLabelText   $csharpLabel

關於具有動態內容和樣式的標題和頁腳實施，請參閱新增標題和頁腳指南。

如何選擇性地將邊界應用於標題和頁腳？

指定哪些邊界適用於標題和頁腳。 有關詳細配置，請參見API參考。 範例：

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-specific-margins-header-footer.cs
// Use only the left margin from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.Left;

// Use only the left and right margins from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.LeftAndRight;
' Use only the left margin from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.Left

' Use only the left and right margins from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.LeftAndRight
$vbLabelText   $csharpLabel

何時應使用不同的標題/頁腳邊界配置？

針對標題和頁腳的選擇性邊界配置適用於具有非對稱佈局的文件，如具有交替頁面邊界的書籍，或標題延伸至頁邊的同時保持正文邊界的文件。

常見的使用案例：

  • 圖書出版：用於裝訂的交替內/外邊界
  • 信頭文件：全寬標頭與受限正文
  • 表格和模板：字段與說明不同的邊界
  • 多欄佈局：全寬標頭與欄位邊界
Icon Quote related to 何時應使用不同的標題/頁腳邊界配置？

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic related to 何時應使用不同的標題/頁腳邊界配置？

Milan Jovanovic

Microsoft MVP

查看案例研究
Icon Quote related to 何時應使用不同的標題/頁腳邊界配置？

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle related to 何時應使用不同的標題/頁腳邊界配置？

Brent Matzelle

首席技術官，OPYN

查看案例研究
Icon Quote related to 何時應使用不同的標題/頁腳邊界配置？

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones related to 何時應使用不同的標題/頁腳邊界配置？

David Jones

首席軟體工程師，Agorus Build

查看案例研究

進階邊界考量

處理分頁和邊界

自訂邊界與分頁互動。 IronPDF處理跨頁內容流，尊重邊界設定，確保多頁文件中格式一致。

邊界單位和精度

IronPDF使用毫米作為邊界單位。 從其他單位轉換：

  • 英寸轉毫米：乘以25.4
  • 點數轉毫米：乘以0.352778
  • 像素轉毫米：依據DPI而定（在96 DPI下，乘以0.264583）

IronPDF在需要時支持小數值，以提供亞毫米級的精度。

邊界的性能優化

對於具有自訂邊界的大型文件：

  1. 在renderer級別設置邊界
  2. 在相似文件中使用一致的值
  3. 將邊界設置與其他呈現選項結合使用

與其他IronPDF功能的整合

自訂邊界可與IronPDF的其他功能協同工作：

總結

在IronPDF中設置自訂邊界提供對PDF佈局和格式的精確控制。 無論是建立商業文件、學術論文還是自訂報告，IronPDF的邊界系統確保PDF符合確切要求。 探索文件，了解IronPDF如何簡化PDF生成工作流程。

常見問題

如何在C#中為PDF設定自訂邊距？

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

邊距測量使用哪些單位？

IronPDF在RenderingOptions中使用毫米（mm）作為所有邊距設定的單位。這提供了對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中設置窄邊距時，將所有邊距值設為12.7mm（0.5英寸）在RenderingOptions中。這最大化列印區域，同時保持專業外觀：RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }。

Why are my CSS @page margins ignored, and how do I make them take precedence?

By default IronPDF adds CSS @page margins to your RenderingOptions margins. To choose which wins, set RenderingOptions.CssPageRulePolicy: Default keeps the legacy additive behavior, RenderingOptionsWin strips @page margins and uses your C# margins, and CssPageWin applies the @page margins. It controls margins only, not page size or orientation, and under CssPageWin you should give any header or footer a fixed MaxHeight.

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 20,296,129 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。