使用Base64图像页眉和页脚减少文件大小
Curtis Chau
Updated: 2026年7月3日
在大型多页PDF上添加Base64图像到页眉或页脚可以显著增加输出文件大小。 解决方法是将图像嵌入一次，而不是在每页都嵌入，同时仍然能让每页的文本如{page}正常渲染。
膨胀是因为渲染器如何处理组合片段导致的。 当一个片段同时包含图像和动态内容如{page}时，引擎将所有HTML视为动态内容，从而在每页重新嵌入Base64图像。 将工作分为两步可以让图像保持静态，页码层保持小。
解决方案
1. 将页眉或页脚分成两个片段
将内容分成一个静态片段和一个动态片段。 将不变的图像和文本放在静态片段中。 将每页内容如{page}放在动态片段中。 使两个片段拥有相同的表格布局和单元格宽度，以便动态文本准确落在静态层上。
2. 先添加静态片段
仅调用AddHtmlHeadersAndFooters静态片段。 Base64图像将被渲染并嵌入一次。
3. 第二步添加动态片段
再次调用AddHtmlHeadersAndFooters仅包含动态片段。 由于这一步没有携带图像，每页内容依然很小。
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");C#
两个table-layout:fixed片段共享相同的单元格宽度，因此第二步骤中的页码恰好位于第一步骤中的空单元格位置。相同技术适用于页眉：将图像保留在静态步骤，并在第二步骤放置任何动态页眉文本。
警告: 如果两个片段没有共享相同的表格结构和单元格宽度，动态文本如页码将无法对齐到静态层上。
选项：引用外部图像或SVG
如果您不需要图像内联为Base64，将<img>指向外部文件或使用SVG可以使输出大小比Base64字符串更小。
技术作家
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
...
阅读更多
