Ein PDF, das Bilder über Dateipfad oder URL referenziert, hat eine versteckte Abhängigkeit. Sobald das Dokument die Maschine verlässt, die es erstellt hat, in einer zustandslosen Cloud-Funktion läuft oder jahrelang archiviert wird, können diese Referenzen unterbrochen werden und leere Felder hinterlassen, wo das Logo oder das Diagramm sein sollte. Das Einbetten von Bildern direkt im HTML als base64-Daten-URIs beseitigt diese Abhängigkeit, und IronPDF rendert das Ergebnis in ein vollständig eigenständiges PDF.

Das geschäftliche Problem

Ein Rechnungsdienst zieht nach Azure oder AWS Lambda um, wo der Dateizugriff beschränkt und vorübergehend ist, sodass die Bildpfade, die lokal funktioniert haben, nicht mehr aufgelöst werden. Ein Berichterstellungstool sendet Dokumente per E-Mail, die auch noch Jahre später korrekt angezeigt werden müssen, nachdem der ursprüngliche Asset-Server geändert wurde. Eine Pipeline erstellt Dokumente aus Bildern, die zur Laufzeit generiert wurden und nie auf der Festplatte gespeichert wurden. In jedem Fall sind externe Bildreferenzen eine Haftung.

Bilder als Daten-URIs einbetten

Das Muster besteht aus drei Schritten: die Bild-Bytes lesen, sie zu base64 konvertieren und das Ergebnis in einem <img>-Tag mit dem passenden MIME-Typ platzieren. Das gerenderte PDF hält dann das Bild innerhalb der Datei.

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

Der gleiche Ansatz funktioniert für zur Laufzeit generierte Bilder, wie zum Beispiel ein Diagramm oder Barcode, der im Speicher erstellt wurde, indem die Bytes direkt kodiert werden, ohne eine temporäre Datei zu schreiben. Mehrere Formate werden unterstützt, solange die Daten-URI den richtigen Typ angibt: PNG, JPEG, GIF, SVG (image/svg+xml) und WebP.

Punkte, die zu planen sind

• Base64 erhöht die Größe: Kodierung erhöht die Bytegröße jedes Bildes um etwa ein Drittel, was sowohl im HTML als auch im PDF landet. Für bildlastige Dokumente vor dem Kodieren komprimieren oder die Größe anpassen und danach PDF-Komprimierung anwenden.
• MIME-Typ abgleichen: Der Präfix muss dem Format entsprechen, wie data:image/jpeg;base64, für ein JPEG, oder das Bild wird nicht gerendert.
• Keine Dateisystemabhängigkeit: Da das Bild innerhalb des Dokuments reist, ist das Rendern nicht auf einen erreichbaren Pfad oder Asset-Server angewiesen, was es bei Cloud- und Container-Deployments zuverlässig macht.
• Weniger Abrufe: Inline-Bilder vermeiden zusätzliche HTTP- oder Dateisystemaufrufe während des Renderns, was den Durchsatz verbessert, wenn ein Dokument viele kleine Bilder enthält.

Ergebnis

Indem sie Bilder als Daten-URIs einbetten, generiert das Team PDFs, die unabhängig davon, ob sie auf einem Laptop oder in einer serverlosen Funktion laufen, identisch gerendert werden, und die jedes Bild intakt halten, wenn sie per E-Mail gesendet oder archiviert werden. Vollständige Formatdetails und Beispiele finden Sie im Einbetten von Bildern mit DataURIs-Leitfaden.