1. IronPDF
  2. 操作指南
  3. 設置自定義邊距
如何在 C# 中設置自定義邊距

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

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

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

快速入門：使用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;
$vbLabelText   $csharpLabel

邊距設定與 IronPDF 的Chrome 渲染引擎搭配使用，可提供精確的 HTML 到 PDF 轉換。 有關高級 PDF 產生設置，請參閱渲染選項指南。

邊距如何與 CSS 樣式互動？

邊距會加入到 HTML 部分中設定的邊距。 在下面的範例中，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");
$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;
$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;
$vbLabelText   $csharpLabel

何時應該使用不同的頁首/頁腳邊距配置？

對於佈局不對稱的文檔，例如頁面邊距交替的書籍，或者頁眉延伸到頁面邊緣而正文內容保持邊距的書籍，選擇性地配置頁眉和頁腳邊距效果很好。

常見應用場景： 書籍出版：裝訂時採用交替的內/外頁邊距 -信頭檔：全寬頁眉，內文內容受限。 -表單和範本：欄位和說明文字的邊距不同 -多列版面：全寬標題，附列邊距

高級利潤率考量

處理分頁符號和頁邊距

自訂邊距與分頁符號互動。 IronPDF能夠處理跨頁面的內容流，同時遵循邊距設置，確保多頁文件格式的一致性。

邊際單位和精度

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

  • 吋換算成毫米：乘以 25.4
  • 點到毫米：乘以 0.352778
  • 像素到毫米的轉換：隨 DPI 而變化(96 DPI 時，乘以 0.264583)

IronPDF支援小數，必要時可達到亞毫米級精度。

利用裕量進行效能最佳化

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

  1. 在 renderer 等級設定一次邊距
  2. 在類似文件中使用一致的值
  3. 將邊距設定與其他渲染選項結合使用

與其他IronPDF功能的集成

自訂邊距可與其他IronPDF功能搭配使用： 水印和印章尊重邊界 PDF壓縮保持完整性 -數位簽章相對於頁邊距的位置

結論

在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 使用毫米 (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 }。

Jordi Bardia
Jordi Bardia
  立即與工程團隊聊天
軟體工程師
Jordi 在 Python、C# 和 C++ 上最得心應手，當他不在 Iron Software 展現技術時，便在做遊戲編程。在分担產品测测试，產品開發和研究的责任時，Jordi 為持续的產品改進增值。他说这种多样化的经验使他受到挑战并保持参与, 而这也是他与 Iron Software 中工作一大乐趣。Jordi 在佛罗里达州迈阿密长大，曾在佛罗里达大学学习计算机科学和统计学。
準備好開始了嗎？
Nuget 下載 17,803,474 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎？

想快速取得證據？ PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。