1. IronPDF
  2. 操作指南
  3. 設定自訂邊距
如何在 PDF 中設定自訂邊距（C#）

How to Set Custom Margins

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

在處理PDF或任何其他文件類型時，經常需要指定邊界以符合不同的標準。 例如，MLA和APA格式都需要1英吋格式，而某些大學可能要求論文使用1.5英吋邊界。

快速入門：使用IronPDF實現自定義PDF邊界)

IronPDF使在從HTML渲染PDF時設置自定義邊界變得容易——只需一些簡單的配置。

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 = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10, UseMarginsOnHeaderAndFooter = true } }
    .RenderHtmlAsPdf("<h1>Hello with margins!</h1>")
    .SaveAs("custom‑margins.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer

as-heading:3(最小工作流程（5步）：

  1. 從NuGet下載IronPDF C#庫以進行邊界配置
  2. 實例化ChromePdfRenderer類以渲染PDF文件
  3. 修改Chrome渲染器的RenderingOptions中的邊界值以進行自定義
  4. 專門為頁眉和頁腳調整邊界
  5. 將HTML渲染為PDF並保存文件

設定自定義邊界示例

若要設置自定義邊界，首先要實例化ChromePdfRenderer類。 使用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

需要注意的是，這是添加到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示例如下所示：

在頁眉/頁腳中設定自定義邊界

默認情況下，RenderingOptions中設置的邊界不適用於文檔的頁眉和頁腳。 若要在頁眉和頁腳中設置文檔的相同自定義邊界，請在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

常見問題解答

如何使用 C# 在 PDF 文件中設定自訂邊距？

您可以使用 C# 中的 IronPDF 庫在 PDF 文件中設定自訂邊距。實例化ChromePdfRenderer類，並使用RenderingOptions以毫米為單位指定上、下、左、右邊距。

在 IronPDF 中設定自訂邊距需要哪些步驟？

若要在 IronPDF 中設定自訂邊距，先從 NuGet 下載 IronPDF 庫，實例化ChromePdfRenderer ，修改RenderingOptions中的邊距值，然後渲染並儲存 PDF。

我可以為PDF文件的頁首和頁尾設定不同的邊距嗎？

是的，您可以透過在 IronPDF 的RenderingOptions中設定UseMarginsOnHeaderAndFooter屬性，為 PDF 的頁首和頁腳套用不同的邊距。

CSS邊距如何影響IronPDF中設定的邊距？

HTML 中指定的 CSS 邊距會加入到 IronPDF 的RenderingOptions中設定的邊距。例如，如果 HTML 的邊距為 50 毫米，而 IronPDF 又增加了 30 毫米，則總邊距將為 80 毫米。

有沒有辦法透過影片學習如何設定頁邊距？

是的，YouTube 上有一個影片教程，指導如何使用 IronPDF 設定自訂邊距。

IronPDF 中能否以毫米以外的單位指定頁邊距？

不，IronPDF 主要使用毫米來指定邊距。 API 不直接支援其他單位。

IronPDF中頁首和頁尾的預設邊距行為是什麼？

預設情況下，IronPDF 的RenderingOptions中指定的邊距不適用於頁首和頁尾。若要套用相同的邊距，請啟用UseMarginsOnHeaderAndFooter 。

在哪裡可以找到更多關於在 IronPDF 中設定自訂邊距的範例？

有關在 IronPDF 中設定自訂邊距的更多範例，請參閱本文中提供的綜合 API 參考和程式碼範例。

IronPDF 在設定自訂邊距時是否完全相容於 .NET 10？

是的，IronPDF 完全支援 .NET 10，包括所有渲染選項，例如自訂邊距、頁首/頁腳邊距設定以及 HTML/CSS 邊距整合。您可以在 .NET 10 專案中直接使用相同的程式碼模式，無需修改。

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