圖像頁首和頁尾不增加文件大小

Curtis Chau
Curtis Chau
已更新: 2026年10月29日

將Base64標誌添加到PDF的頁首或頁尾可能會使輸出文件增大,因為每一頁都會重新嵌入圖像。 將頁首或頁尾分為靜態圖像層和動態文本層,以便圖像僅嵌入一次,而每頁內容保持小。

解決方案

1. 將頁首或頁尾分成兩個HTML片段

根據內容變更的頻率分隔內容。 將圖像和任何不會更改的文本放在一個靜態片段中,而將每頁內容如{page}放在動態片段中。 給兩個片段相同的表格佈局和匹配的單元格寬度,以確保動態文本正確對齊在靜態層上。

2. 先加入靜態片段

僅使用靜態片段調用AddHtmlHeadersAndFooters。 Base64圖片只會渲染並嵌入一次。

3. 在第二次執行中加入動態片段

僅使用動態片段再次調用AddHtmlHeadersAndFooters。 這次執行中不含圖片,所以每頁的內容保持小。 將靜態和動態部分一起渲染會導致引擎將所有HTML視為動態並在每頁上重新嵌入圖片,這會導致文件增大。

using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
// Static layer: holds the Base64 image. The page-number cell is left empty.
string staticFooter = @"
<table style='width:100%; table-layout:fixed;'>
  <tr>
    <td style='width:20%;'>
      <img src='data:image/png;base64,iVBORw0KGg...' style='width:150px;' />
    </td>
    <td style='width:80%; text-align:right;'></td>
  </tr>
</table>";
// Dynamic layer: holds only {page}. Same layout, but no image.
string dynamicFooter = $@"
<table style='width:100%; table-layout:fixed;'>
  <tr>
    <td style='width:20%;'></td>
    <td style='width:80%; text-align:right; font-size:10px;'>Page {{page}} of {pdf.PageCount}</td>
  </tr>
</table>";
// Pass 1: add the static image footer (image embedded once).
pdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
{
    HtmlFooter = new HtmlHeaderFooter { HtmlFragment = staticFooter, MaxHeight = 40 }
});
// Pass 2: add the dynamic page-number footer (no image, stays small).
pdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
{
    HtmlFooter = new HtmlHeaderFooter { HtmlFragment = dynamicFooter, MaxHeight = 40 }
});
pdf.SaveAs("output.pdf");

第一次處理將Base64圖像載入在staticFooter中; 第二次處理僅在dynamicFooter中載入Page {page} of ...。 兩個表格使用相同的單元格寬度,確保頁碼對齊在靜態層上。

4. (可選) 參考外部圖片或SVG

為了進一步縮小輸出,將<img>標籤指向外部圖像文件,或使用SVG代替Base64字串內嵌圖像。

注意事項和限制

  • 需要匹配的佈局:兩個片段必須共享相同的表格結構和單元格寬度,否則動態文本(如頁碼)將無法對齊在靜態層上。
  • 比Base64更小:外部圖像文件或SVG可以進一步減少文件大小。
  • 包括頁首:相同的技術也適用於頁首。 在靜態過程中保留圖像,並在第二次處理中放置任何動態頁首文本。
請注意: 從v2026.6.1開始,IronPDF將頁首和頁尾分開處理。 如果圖像在頁首而{page}只在頁尾,或反之,圖像只嵌入一次,您不需要兩次處理。 當圖像和{page}在同一頁首或頁尾時,使用上面的兩次處理方法。

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 22,198,312版本:2026.11剛剛發布