1. IronPDF
  2. 如何使用
  3. 設定自訂邊界
如何在 PDF 中設定自訂邊界 C#

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

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 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

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

常見問題解答

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

您可以使用 C# 中的 IronPDF 函式庫在 PDF 文件中設定自訂邊距。Instantiate the ChromePdfRenderer class and use the RenderingOptions to specify margins in millimeters for the top, bottom, left, and right sides.

在 IronPDF 中设置自定义页边距需要哪些步骤？

若要在 IronPDF 中設定自訂頁邊，請先從 NuGet 下載 IronPDF 函式庫，實體化 ChromePdfRenderer ，修改 RenderingOptions 中的頁邊值，然後繪製並儲存 PDF。

我可以在 PDF 的頁首和頁尾套用不同的頁邊空白嗎？

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

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

HTML 中指定的 CSS 邊界會添加到 IronPDF 的 RenderingOptions 中設定的邊界。例如，如果 HTML 有 50 mm 的頁邊，而 IronPDF 又增加了 30 mm，則總頁邊就是 80 mm。

有沒有辦法利用影片學習如何設定頁邊空白？

是的，YouTube 上有一個視訊教學，提供使用 IronPDF 設定自訂頁邊空白的指導。

在 IronPDF 中，可以用毫米以外的單位指定頁邊距嗎？

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

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

根據預設，IronPDF 的 RenderingOptions 中指定的頁邊空白不適用於頁首和頁尾。若要套用相同的頁邊，請啟用 UseMarginsOnHeaderAndFooter 。

我在哪裡可以找到在 IronPDF 中設定自訂頁邊的其他範例？

如需在 IronPDF 中設定自訂頁邊空白的其他範例，請參閱文章中提供的全面 API Reference 和程式碼範例。

IronPDF 在設定自訂頁邊空白時，是否與 .NET 10 完全相容？

是的，IronPDF for .NET 完全支持 .NET 10，包括所有渲染选项，如自定义页边距、页眉/页脚页边距设置以及 HTML/CSS 页边距集成。您可以在 .NET 10 專案中使用相同的程式碼模式，無需修改。

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