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

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

Curtis Chau
Curtis Chau
更新:
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. using 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 邊距為 50mm，而 RenderingOptions 增加了 30mm，因此總邊距為 80mm：

: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 和媒體查詢，可實現 Professional 版面配置。 此邊距行為在將 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

何時應使用不同的頁首/頁尾邊距設定？

針對頁首和頁尾的選擇性邊距設定，對於具有非對稱版面的文件非常有效，例如頁面邊距交替變化的書籍，或是頁首延伸至頁面邊緣而正文內容仍保持邊距的文件。

常見使用情境：

  • 書籍出版：為裝訂而交替設定內外邊距
  • 信頭文件：全寬頁首搭配受限的正文區塊
  • 表單與範本：欄位與說明文字的邊距設定不同
  • 多欄版面配置：帶有欄邊距的全寬標題

進階邊距考量

處理分頁與邊距

自訂邊距會影響分頁位置。 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 設定了 50 公釐的邊距，而您在 RenderingOptions 中設定了 30 公釐，最終生成的 PDF 總邊距將為 80 公釐。此機制讓您能在保留 HTML 樣式的同時，靈活控制版面間距。

我可以為頁首和頁尾設定邊距嗎？

是的，IronPDF 在 RenderingOptions 中提供了 UseMarginsOnHeaderAndFooter 屬性。將此屬性設定為 true，即可將自訂邊距套用至頁首和頁尾，確保 PDF 文件全篇的間距保持一致。

學術排版格式建議的邊距值為何？

針對使用 IronPDF 的學術文件，MLA/APA 格式請設定 25.4 公釐（1 英吋），論文請設定 38.1 公釐（1.5 英吋），或歐洲 A4 標準請設定 20 公釐。這些數值可透過 MarginTop、MarginBottom、MarginLeft 和 MarginRight 屬性輕鬆設定。

Chrome 的渲染引擎會影響邊距的準確性嗎？

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

我可以為 PDF 的每一邊設定不同的邊距嗎？

沒問題。IronPDF 允許透過獨立的屬性（MarginTop、MarginBottom、MarginLeft 和 MarginRight）分別控制四個邊距。這使得可以實現非對稱版面配置，例如頂部和底部邊距較大的商務信函。

如何設定窄邊距以最大化內容區域？

若要在 IronPDF 中設定窄邊距，請在 RenderingOptions 中將所有邊距值設為 12.7 公釐（0.5 英吋）。此設定可在維持 Professional 外觀的同時，最大化可列印區域：RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }。

Curtis Chau
Curtis Chau
  立即與工程團隊聯繫
技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？
Nuget 下載 19,014,616 | 版本： 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。