Bild-Header oder -Footer ohne Dateigrößenwachstum
Das Hinzufügen eines Base64-Logos zu einem PDF-Header oder -Footer kann die Ausgabedatei aufblähen, da das Bild auf jeder Seite erneut eingebettet wird. Teilen Sie den Header oder Footer in eine statische Bildebene und eine dynamische Textebene auf, sodass das Bild einmal eingebettet wird, während der seitenweise Inhalt klein bleibt.
Lösung
1. Header oder Footer in zwei HTML-Fragmente aufteilen
Trennen Sie den Inhalt nach der Häufigkeit seiner Änderungen. Legen Sie das Bild und jeden Text, der sich nie ändert, in einem statischen Fragment ab und platzieren Sie seitenweise Inhalte wie {page} in einem dynamischen Fragment. Verwenden Sie für beide Fragmente das gleiche Tabellenlayout mit übereinstimmender Zellenbreite, damit der dynamische Text an der richtigen Position über der statischen Ebene landet.
2. Das statische Fragment zuerst hinzufügen
Rufen Sie AddHtmlHeadersAndFooters nur mit dem statischen Fragment auf. Das Base64-Bild wird einmal gerendert und eingebettet.
3. Das dynamische Fragment in einem zweiten Durchgang hinzufügen
Rufen Sie AddHtmlHeadersAndFooters erneut nur mit dem dynamischen Fragment auf. Dieser Durchgang enthält kein Bild, sodass der Inhalt pro Seite klein bleibt. Das Rendern der statischen und dynamischen Teile zusammen führt dazu, dass die Engine das gesamte HTML als dynamisch behandelt und das Bild auf jeder Seite erneut eingebettet wird, was die Datei wachsen lässt.
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");Imports IronPdf
Dim pdf = PdfDocument.FromFile("input.pdf")
' Static layer: holds the Base64 image. The page-number cell is left empty.
Dim staticFooter As String = "
<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.
Dim dynamicFooter As String = $"
<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 With {
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = staticFooter, .MaxHeight = 40}
})
' Pass 2: add the dynamic page-number footer (no image, stays small).
pdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = dynamicFooter, .MaxHeight = 40}
})
pdf.SaveAs("output.pdf")Imports IronPdf
Dim pdf = PdfDocument.FromFile("input.pdf")
' Static layer: holds the Base64 image. The page-number cell is left empty.
Dim staticFooter As String = "
<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.
Dim dynamicFooter As String = $"
<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 With {
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = staticFooter, .MaxHeight = 40}
})
' Pass 2: add the dynamic page-number footer (no image, stays small).
pdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = dynamicFooter, .MaxHeight = 40}
})
pdf.SaveAs("output.pdf")Der erste Durchgang trägt das Base64-Bild in staticFooter; der zweite Durchgang trägt nur Page {page} of ... in dynamicFooter. Beide Tabellen verwenden identische Zellenbreiten, sodass die Seitennummer über der statischen Ebene ausgerichtet ist.
4. (Optional) Ein externes Bild oder SVG referenzieren
Um die Ausgabe weiter zu verkleinern, verweisen Sie das <img>-Tag auf eine externe Bilddatei oder verwenden Sie ein SVG anstelle des Einbettens des Bildes als Base64-String.
Hinweise und Einschränkungen
- Entsprechende Layout erforderlich: beide Fragmente müssen die gleiche Tabellenstruktur und Zellenbreiten teilen, oder der dynamische Text, wie die Seitennummer, wird nicht über der statischen Ebene ausgerichtet.
- Kleiner als Base64: Eine externe Bilddatei oder ein SVG kann die Dateigröße weiter reduzieren als ein Base64-String.
- Auch für Header: Die gleiche Technik gilt für Header. Halten Sie das Bild im statischen Durchgang und platzieren Sie jeglichen dynamischen Headertext im zweiten Durchgang.
v2026.6.1 aus behandelt IronPDF den Header und den Footer separat. Wenn das Bild im Header und {page} nur im Footer ist oder umgekehrt, wird das Bild einmal eingebettet und Sie benötigen keine zwei Durchgänge. Verwenden Sie die obige Zwei-Durchgänge-Methode, wenn sich das Bild und {page} im selben Header oder im selben Footer befinden.Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.