MaxHeight vs UseMarginToHeaderAndFooter

Curtis Chau

已更新:2026年6月28日

Translated

View the article in English

當您生成帶有頁首和頁尾的PDF時，兩個屬性通常會被混淆：UseMarginToHeaderAndFooter。它們控制不同的事物，將它們混合會導致內容被剪切或意外重疊。以下是每個屬性的功能及其適用時機。

MaxHeight

MaxHeight設置渲染PDF時頁首或頁尾區域的最大高度。預設情況下，IronPDF會動態調整此高度，以適應所有頁首或頁尾內容。

手動降低MaxHeight會剪切或隱藏超出您設定值的內容。反之，過大的值不會增大可見的頁首或頁尾； IronPDF會回退到其預設尺寸，以保持版面穩定。

MaxHeight為10的渲染PDF，其中頁首文字被剪切

MaxHeight為15的渲染PDF，其中頁首文字部分被剪切

MaxHeight為50的渲染PDF，顯示完整的頁首

MaxHeight為100的渲染PDF，顯示與預設相同尺寸

請注意MaxHeight不會在頁首或頁尾與主要文件內容之間新增任何邊距。它只限制該區域的高度。

UseMarginToHeaderAndFooter

頁首和頁尾有其自己的佈局處理，與通過ChromePdfRenderOptions設定的內容邊距分開。為了精確的間距，直接在Footer物件的HTML中定義邊距：

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style=""margin-top: 20px; margin-right: 40px; margin-bottom: 10px; margin-left: 30px; background-color: lightblue;"">
   This is Header
  </div>",
  DrawDividerLine = true,
  MaxHeight = 30
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style=""margin-top: 20px; margin-right: 40px; margin-bottom: 10px; margin-left: 30px; background-color: lightblue;"">
   This is Header
  </div>",
  DrawDividerLine = true,
  MaxHeight = 30
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style=""margin-top: 20px; margin-right: 40px; margin-bottom: 10px; margin-left: 30px; background-color: lightblue;"">
   This is Header
  </div>",
    .DrawDividerLine = True,
    .MaxHeight = 30
}
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

$vbLabelText $csharpLabel

在其自己的HtmlFragment中設計頁首可保持間距可預測，因為邊距與其所適用的內容共存。

UseMarginToHeaderAndFooter屬性將主要內容的邊距（例如左右）延伸至頁首和頁尾區域。謹慎使用：以這種方式應用垂直邊距（上下）通常會導致內容重疊及其他意外情況。