Bilder in PDFs einbetten mit C# und IronPDF

Warum funktioniert die Methode RenderHtmlAsPdf am besten?

Die Methode RenderHtmlAsPdf nutzt die Chrome-Rendering-Engine von IronPDF, um HTML-Inhalte, einschließlich Bilder, in das PDF-Format zu konvertieren und dabei Layout und Stil beizubehalten. Diese Methode unterstützt responsive CSS-Layouts und stellt sicher, dass Bilder so dargestellt werden, wie sie in einem Webbrowser erscheinen. Für komplexe Layouts lesen Sie bitte unseren Leitfaden zur pixelgenauen HTML-Formatierung.

Welche Bildformate werden unterstützt?

IronPDF unterstützt alle gängigen Bildformate, einschließlich PNG, JPG, SVG, GIF und BMP, wenn sie durch HTML-Konvertierung eingebettet werden. Die Bibliothek verarbeitet SVG-Grafiken effektiv für skalierbare Vektorillustrationen. Wenn Sie mit verschiedenen Formaten arbeiten, stellen Sie sicher, dass Ihr HTML den Bildtyp im src Attribut oder in der Base64-Daten-URI korrekt angibt.

Wann sollte ich Direct URL vs. Base64 Encoding verwenden?

Verwenden Sie direkte URLs, wenn die Bilder online gehostet werden und die Dateigröße ein Problem darstellt. Wählen Sie Base64-Kodierung für in sich geschlossene PDFs, die keinen Internetzugang erfordern. Für Bilder, die in Cloud-Diensten gespeichert sind, siehe unsere Anleitung zum Einbetten von Bildern aus Azure Blob Storage. Diese Entscheidung wirkt sich sowohl auf die Dateigröße als auch auf die Übertragbarkeit der generierten PDFs aus.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private html As String = "<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export PDF
pdf.SaveAs("embedImage.pdf")

Warum Base64-Kodierung für Bilder verwenden?

Die Base64-Kodierung erzeugt in sich geschlossene PDF-Dateien, die nicht auf externe Ressourcen angewiesen sind. So wird sichergestellt, dass die Bilder auch ohne Internetverbindung oder beim Verschieben oder Löschen der Originalbilddateien angezeigt werden. Diese Technik ist nützlich bei der Erstellung von PDFs in Blazor Server-Anwendungen oder bei der Bereitstellung auf Azure, wo der externe Dateizugriff eingeschränkt sein könnte. Die kodierten Bilder werden Teil des HTML-Strings und eignen sich daher ideal für HTML-String-zu-PDF-Konvertierungen.

Was sind die Leistungserwägungen?

Die Base64-Kodierung erhöht die Dateigröße um ca. 33 %, beseitigt aber externe Abhängigkeiten, was sie ideal für Archivierungszwecke oder eingeschränkte Netzwerkumgebungen macht. Wenn die Leistung entscheidend ist, sollten Sie die async PDF generation verwenden, um mehrere Bildkonvertierungen gleichzeitig zu verarbeiten. Für große Projekte finden Sie in unserem Leitfaden zur Leistungsoptimierung eine Anleitung zur Maximierung des Durchsatzes.

Wie gehe ich mit großen Bilddateien um?

Komprimieren Sie große Bilder vor der Base64-Kodierung, um die Größe der PDF-Datei zu verringern, oder verwenden Sie externe URLs, wenn die Dateigröße entscheidend ist. IronPDF bietet PDF-Komprimierungsfunktionen, die die Dateigröße um bis zu 75 % reduzieren können. Wenn Sie mit mehreren Bildern arbeiten, optimieren Sie Ihre Rendering-Einstellungen, um ein optimales Gleichgewicht zwischen Qualität und Dateigröße zu erreichen.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");

Imports IronPdf
Imports System
Imports System.IO

Private renderer As New ChromePdfRenderer()

' Import image file binary data
Private binaryData() As Byte = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg")

' Convert the binary data to base 64
Private imgDataUri As String = Convert.ToBase64String(binaryData)

' Embed in HTML
Private html As String = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>"

' Convert HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export the PDF
pdf.SaveAs("embedImageBase64.pdf")

Bereit zu sehen, was Sie sonst noch tun können? Sehen Sie sich hier unsere Tutorial-Seite an: Zusätzliche Funktionen