Die Konvertierung von JPEG-Bildern zu PDF in C# benötigt nur wenige Codezeilen mit der IronPDF-Klasse ImageToPdfConverter. Die Bibliothek verarbeitet Einzelbilder, Stapelkonvertierungen und mehrere Bildformate und erhält dabei die Qualität des resultierenden PDF-Dokuments.
Für Entwickler, die Dokumentenmanagementsysteme, Archivierungswerkzeuge oder automatisierte Arbeitsabläufe erstellen, ist die Konvertierung von JPG-Bildern in PDF eine wiederkehrende Anforderung. PDF ist das universelle Dokumentenformat – es wird auf Windows, Mac, Linux und Mobilgeräten einheitlich dargestellt, ohne dass Bildbetrachter oder zusätzliche Plugins erforderlich sind. Bei der programmatischen Konvertierung von JPEG-Dateien können Sie den Prozess automatisieren, Branding anwenden, mehrere Bilder zusammenführen und jeden Aspekt des Ergebnisses kontrollieren.
Dieses Tutorial beschreibt den gesamten Prozess der Konvertierung von JPEG zu PDF in .NET mit C# und IronPDF. Sie lernen die Konvertierung einzelner Bilder, die Stapelverarbeitung, die Formatunterstützung, die Steuerung der Bildplatzierung und die Anpassung nach der Konvertierung. Jeder Abschnitt enthält funktionierenden C#-Code, den Sie an Ihr eigenes Projekt anpassen können.
Bevor Sie mit dem Schreiben des Konvertierungscodes beginnen, fügen Sie IronPDF zu Ihrem .NET -Projekt hinzu. Die Bibliothek wird über NuGet verteilt und lässt sich in Sekundenschnelle installieren.
Öffnen Sie die Paketmanager-Konsole in Visual Studio und führen Sie den Befehl aus:
Oder verwenden Sie die .NET-CLI:
IronPDF zielt auf .NET 8, .NET 9 und .NET 10 sowie .NET Framework 4.6.2 und höher ab. Es sind keine zusätzlichen Laufzeitabhängigkeiten erforderlich – das Paket enthält alles, was für die Bild-zu-PDF-Konvertierung unter Windows, Linux, macOS, Docker und Azure benötigt wird.
Sobald es installiert ist, fügen Sie eine einzelne using IronPdf;-Anweisung am Anfang Ihrer Datei hinzu und Sie sind bereit, mit der Konvertierung zu beginnen.
Das IronPDF NuGet Paket enthält die Rendering-Engine, sodass für Produktionsserver kein separates Installationsprogramm erforderlich ist. Bei Cloud-Bereitstellungen konsultieren Sie bitte die Docker-Einrichtungsanleitung, um das richtige Basis-Image zu konfigurieren.
Der einfachste Weg zur JPEG-zu-PDF-Konvertierung verwendet die statische Methode ImageToPdfConverter.ImageToPdf(). Übergeben Sie den Bilddateipfad, erhalten Sie ein PdfDocument-Objekt und speichern Sie es, wo immer Sie es benötigen.
using IronPdf;
// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);
// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");Imports IronPdf
' Convert a single JPG image to PDF
Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)
' Save the converted PDF file
pdf.SaveAs("converted-photo.pdf")Die Methode ImageToPdf akzeptiert den Dateipfad zu Ihrer JPEG-Datei und gibt ein PdfDocument-Objekt zurück, das Sie speichern, streamen oder an andere IronPDF-Operationen übergeben können. Die Konvertierung erfolgt im Arbeitsspeicher, was sie ideal für Webanwendungen macht, die die PDF-Datei direkt ausliefern müssen, ohne auf die Festplatte zuzugreifen.
Die ausgegebene PDF-Datei behält die ursprüngliche Bildqualität bei und verpackt sie in ein Format, das von jedem PDF-Reader geöffnet werden kann. Die Seitengröße wird automatisch angepasst – die PDF-Seitenabmessungen entsprechen standardmäßig den Bildabmessungen, sodass Sie eine saubere Ausgabe ohne weiße Ränder erhalten, es sei denn, Sie fordern diese an. Falls Sie bestimmte Ränder benötigen, verwenden Sie die Custom Margins API .
Für Entwickler, die bereits mit der Konvertierung von HTML in PDF vertraut sind, folgt die Bildkonvertierungs-API dem gleichen Muster: Eingabedaten eingeben, bei Bedarf Optionen konfigurieren und die Ausgabe speichern.
IronPDF komprimiert das JPEG während der Konvertierung nicht erneut. Die Bilddaten werden in ihrer Originalauflösung in die PDF-Datei eingebettet, wodurch die visuelle Qualität der Ausgabedatei der Quelldatei entspricht. Wenn Ihre JPEG-Eingabedatei beispielsweise 300 dpi hat, beträgt die Auflösung des eingebetteten Bildes in der PDF-Datei ebenfalls 300 dpi.
Die ImageToPdf-Beispielseite zeigt mehrere Vorher-Nachher-Vergleiche verschiedener Bildtypen. Für eine präzise Dimensionskontrolle kombinieren Sie ImageBehavior-Optionen mit benutzerdefinierten Papiergrößen und Seitenausrichtungseinstellungen.
Beim Erstellen von APIs oder Webanwendungen müssen Sie häufig das PDF als Bytestream und nicht als Datei zurückgeben. Das PdfDocument-Objekt unterstützt dies direkt:
using IronPdf;
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);
// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;
// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");Imports IronPdf
Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)
' Get the PDF as a byte array for streaming
Dim pdfBytes As Byte() = pdf.BinaryData
' In an ASP.NET Core controller:
' Return File(pdfBytes, "application/pdf", "converted.pdf")Dieses Muster funktioniert in ASP.NET Core, Blazor Anwendungen und MAUI-Projekten . Die PDF-Bytes können auch direkt in Azure Blob Storage oder einem beliebigen Cloud-Speicheranbieter gespeichert werden.
Die Stapelkonvertierung – das Zusammenfügen mehrerer JPEG-Bilder zu einer einzigen PDF-Datei – ist genauso unkompliziert. Übergeben Sie eine Aufzählung von Dateipfaden an ImageToPdfConverter.ImageToPdf() und die Bibliothek platziert jedes Bild auf seiner eigenen Seite im Ausgabeergebnis.
using IronPdf;
using System.IO;
using System.Linq;
// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
.Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
|| f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));
// Convert multiple JPEG images to a single PDF file
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);
// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");Imports IronPdf
Imports System.IO
Imports System.Linq
' Gather all JPG files from a folder
Dim imagePaths = Directory.EnumerateFiles("photos") _
.Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) _
OrElse f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase))
' Convert multiple JPEG images to a single PDF file
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)
' Save the combined PDF
pdf.SaveAs("photo-collection.pdf")Die Bilder erscheinen im PDF in der gleichen Reihenfolge, in der sie in der Aufzählung erscheinen. Um die Seitenreihenfolge zu steuern, sortieren Sie die Dateipfade, bevor Sie sie an den Konverter übergeben – zum Beispiel nach Dateiname, Erstellungsdatum oder einer beliebigen benutzerdefinierten Sortierung, die zu Ihrem Workflow passt.
Die Seitenreihenfolge im Ausgabe-PDF entspricht der Reihenfolge der Eingabe-Enumerable. Sortieren Sie nach Dateinamen für alphabetische Ordnung, nach File.GetCreationTime() für chronologische Ordnung oder wenden Sie eine benutzerdefinierte IComparer an, um exakt die gewünschte Reihenfolge zu erhalten. Sobald die Pfade sortiert sind, übergeben Sie sie an ImageToPdfConverter.ImageToPdf() und das resultierende PDF reflektiert diese Reihenfolge.
Für fortgeschrittenere Batch-Workflows, bei denen jedes Bild unterschiedliche Einstellungen benötigt, konvertieren Sie Bilder einzeln und führen Sie die Ergebnisse dann mit PdfDocument.Merge() zusammen:
using IronPdf;
using System.Collections.Generic;
using System.IO;
using System.Linq;
var imagePaths = Directory.EnumerateFiles("photos")
.Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));
var pdfDocuments = new List<PdfDocument>();
foreach (var imagePath in imagePaths)
{
var individualPdf = ImageToPdfConverter.ImageToPdf(
imagePath,
ImageBehavior.FitToPageAndMaintainAspectRatio
);
pdfDocuments.Add(individualPdf);
}
// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");Imports IronPdf
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq
Dim imagePaths = Directory.EnumerateFiles("photos") _
.Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase))
Dim pdfDocuments As New List(Of PdfDocument)()
For Each imagePath In imagePaths
Dim individualPdf = ImageToPdfConverter.ImageToPdf( _
imagePath, _
ImageBehavior.FitToPageAndMaintainAspectRatio _
)
pdfDocuments.Add(individualPdf)
Next
' Merge all individual PDFs into one document
Dim combinedPdf As PdfDocument = PdfDocument.Merge(pdfDocuments)
combinedPdf.SaveAs("custom-photo-collection.pdf")Die Merge und Split API unterstützt das Zusammenführen beliebiger Anzahl von PdfDocument-Objekten. Nach dem Zusammenführen können Sie Lesezeichen hinzufügen, um Lesern die Navigation in großen Fotosammlungen zu erleichtern, oder Seitenzahlen über Kopf- und Fußzeilen einfügen.
Für eine sichere Weitergabe kann die resultierende PDF-Datei mit einem Passwort geschützt oder zur langfristigen Archivierung in das PDF/A-Format konvertiert werden.
Der Bild-zu-PDF-Konverter von IronPDF unterstützt neben JPEG eine breite Palette weiterer Formate. Die gleiche ImageToPdfConverter-Klasse verarbeitet PNG-, BMP-, GIF-, TIFF-, SVG- und WebP-Dateien mit identischen Methodenaufrufen -- Sie benötigen keine separaten Codepfade für verschiedene Bildtypen.
| Format | Erweiterungen | Optimale Nutzung | Bemerkenswertes Merkmal |
|---|---|---|---|
| JPEG | .jpg, .jpeg, .jfif | Fotos, gescannte Dokumente | Ausgezeichnetes Kompressionsverhältnis |
| PNG | .png | Grafiken mit Transparenz | Verlustfreie Qualität |
| BMP | .bmp | Unkomprimierte Quellbilder | Rohpixeldaten erhalten |
| GIF | .gif | Einfache Grafiken und Diagramme | Kleine Dateigröße für flache Grafiken |
| TIFF | .tiff, .tif | Hochwertige Scans | Unterstützung für mehrere Seiten |
| SVG | .svg | Vektorgrafiken und Logos | Skalierbar bei jeder Auflösung |
| WebP | .webp | Moderne Webbilder | Überlegene Komprimierung gegenüber JPEG |
Speziell für TIFF-Dateien unterstützt IronPDF die Konvertierung von TIFF-Dateien mit mehreren Einzelbildern in PDF-Dateien , wobei jedes Einzelbild der TIFF-Datei zu einer separaten Seite in der resultierenden PDF-Datei wird. Dies ist besonders nützlich für gescannte, mehrseitige Dokumente, die als TIFF-Archive ankommen.
Neben statischen Rasterbildern verarbeitet IronPDF auch SVG-Vektorgrafiken in voller Auflösung und ist somit ein zuverlässiges Werkzeug zur Konvertierung technischer Diagramme und Symbole ohne Qualitätsverlust. Dieselbe Engine, die Bilder verarbeitet, rendert auch HTML zu PDF , sodass gemischte Inhaltspipelines – Dokumente, die sowohl Bilder als auch HTML-formatierten Text enthalten – gut unterstützt werden.
Im Gegensatz zu browserbasierten oder Online-PDF-Konvertern läuft IronPDF vollständig innerhalb Ihres .NET Prozesses. Dateien verlassen niemals Ihren Server, was für Anwendungen, die vertrauliche Dokumente, medizinische Bilder oder Finanzdaten verarbeiten, von Bedeutung ist.
Standardmäßig passt IronPDF die Größe der PDF-Seite an die Bildabmessungen an. Wenn Sie ein anderes Verhalten benötigen -- Bilder auf eine Standardpapiergröße anpassen, sie mit weißen Rändern zentrieren oder zuschneiden, um die Seite zu füllen -- verwenden Sie das ImageBehavior-Enumeration kombiniert mit ImageToPdfRenderOptions.
using IronPdf;
var renderingOptions = new ImageToPdfRenderOptions
{
ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
PaperSize = PdfPaperSize.A4,
MarginTop = 25,
MarginBottom = 25,
MarginLeft = 25,
MarginRight = 25
};
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");Imports IronPdf
Dim renderingOptions As New ImageToPdfRenderOptions With {
.ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
.PaperSize = PdfPaperSize.A4,
.MarginTop = 25,
.MarginBottom = 25,
.MarginLeft = 25,
.MarginRight = 25
}
Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions)
pdf.SaveAs("formatted-output.pdf")Die verfügbaren ImageBehavior-Werte decken die häufigsten Layoutanforderungen ab:
FitToPageAndMaintainAspectRatio -- skaliert das Bild, um die Seite zu füllen, während die Proportionen erhalten bleibenCenteredOnPage -- platziert das Bild in seiner Originalgröße, zentriert horizontal und vertikalTopLeftCornerOfPage -- verankert das Bild oben links ohne SkalierungCropPage -- passt die Seitengröße exakt an die Bilddimensionen anNach der Konvertierung können Sie weitere Transformationen anwenden. Fügen Sie ein Wasserzeichen mithilfe von HTML-Markup hinzu, fügen Sie Kopf- und Fußzeilen zur Dokumentenidentifizierung hinzu oder drehen Sie Seiten, um die gewünschte Ausrichtung zu erreichen.
Weitere Nachbearbeitungsoptionen umfassen:
Die programmatische JPEG-zu-PDF-Konvertierung ist ein Grundbaustein für viele Dokumenten-Workflows. Das Verständnis der häufigsten Szenarien hilft Ihnen, die richtige Architektur für Ihre Anwendung zu entwerfen.
Dokumentenarchivierung und Compliance – Organisationen, die Papierdokumente scannen, erstellen JPEG-Dateien mit Flachbett- und Dokumentenscannern. Durch die Konvertierung dieser Dateien in das PDF-Format werden die Indizierung, die Langzeitspeicherung im PDF/A-Format und der Zugriff über gängige Dokumentenmanagement-Plattformen ermöglicht. PDF/A ist ein ISO-Standard, der speziell für die Archivierung entwickelt wurde, und IronPDF unterstützt die Erstellung konformer Dateien.
Bericht- und Dashboard-Generierung – Anwendungen, die Diagramme, Screenshots oder Datenvisualisierungen generieren, erfassen die Ausgabe häufig im JPEG-Format. Das Einbetten dieser in PDF-Berichte mittels ImageToPdfConverter ergibt konsistente, druckbare Dokumente, die Stakeholder überprüfen können, ohne Diagrammsoftware zu installieren.
Fotoportfolios und Galerien – Kreative Profis und Immobilienplattformen nutzen die Stapelkonvertierung von JPEG zu PDF, um druckbare Objektblätter, Portfoliobücher und Katalog-PDFs zu erstellen. Die Kombination von Dutzenden von Fotos in einer einzigen navigierbaren PDF-Datei mit Lesezeichen ergibt eine bessere Präsentation als ein Ordner mit Bilddateien.
Automatisierte Upload-Workflows – Webanwendungen, die JPEG-Uploads von Benutzern akzeptieren – Profilfotos, Belege, Ausweisscans – können alle Uploads in PDF normalisieren, um eine einheitliche Weiterverarbeitung zu gewährleisten. Dies vereinfacht Speicherung, Suche und Darstellung, da die Anwendung nur mit einem Format anstatt mit vielen arbeitet.
Laut einer Branchenstudie der PDF Association ist PDF nach wie vor das am weitesten verbreitete Dokumentenformat in Enterprise . Daher zahlt es sich aus, Bilder frühzeitig im Arbeitsablauf in PDF zu konvertieren, was sich positiv auf die Kompatibilität und die langfristige Zugänglichkeit auswirkt.
Das Mozilla Developer Network dokumentiert den PDF-MIME-Typ als application/pdf, was von allen gängigen Browsern ohne Plugins nativ unterstützt wird -- und damit ist PDF das sicherste Format für Dokumente, die in einem Browser angezeigt werden sollen.
Für mehr Sicherheit in all diesen Szenarien unterstützt IronPDF die PDF-Redaktion , um sensible Inhalte dauerhaft zu entfernen, die PDF-Bereinigung, um versteckte Metadaten zu entfernen, und digitale Signaturen zur Dokumentenauthentifizierung.
Eine JPEG-zu-PDF-Konvertierung ist oft nur der Ausgangspunkt. Produktionsanwendungen müssen in der Regel Dokumentmetadaten, Seitenzahlen und das Branding des Unternehmens hinzufügen, bevor die endgültige Datei ausgeliefert wird.
using IronPdf;
using IronPdf.Editing;
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);
// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
CenterText = "Page {page} of {total-pages}",
DrawDividerLine = true,
FontSize = 10
};
pdf.AddTextFooters(footer);
// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;
// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
"<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
30,
VerticalAlignment.Middle,
HorizontalAlignment.Center
);
pdf.SaveAs("final-document.pdf");Imports IronPdf
Imports IronPdf.Editing
Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)
' Add a text footer with page numbers
Dim footer As New TextHeaderFooter With {
.CenterText = "Page {page} of {total-pages}",
.DrawDividerLine = True,
.FontSize = 10
}
pdf.AddTextFooters(footer)
' Set document metadata
pdf.MetaData.Title = "Converted Photo Document"
pdf.MetaData.Author = "Document Processing System"
pdf.MetaData.CreationDate = System.DateTime.Now
' Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
"<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
30,
VerticalAlignment.Middle,
HorizontalAlignment.Center
)
pdf.SaveAs("final-document.pdf")Bei Stapelkonvertierungen können Sie vor dem Speichern auf jede Seite einer PDF-Datei mit mehreren Bildern dieselbe Fußzeile und dieselben Metadaten anwenden. Die asynchrone Verarbeitungs-API ermöglicht es Umgebungen mit hohem Durchsatz, viele Bilder gleichzeitig zu verarbeiten, ohne Threads zu blockieren.
Bei einer Cloud-basierten Bereitstellung konsultieren Sie bitte den Azure-Bereitstellungsleitfaden und die AWS-Einrichtungsdokumentation für umgebungsspezifische Konfigurationen. Die benutzerdefinierte Logging-API integriert sich mit Serilog, NLog und Microsoft.Erweiterungen.Logging für die operative Überwachung.
Der IronPDF Leitfaden zur Fehlerbehebung behandelt die häufigsten Probleme, die im Produktivbetrieb auftreten, darunter das Laden von Schriftarten, Berechtigungsfehler unter Linux und Darstellungsunterschiede zwischen .NET Versionen.
Die IronPDF-Klasse ImageToPdfConverter bietet Ihnen einen einfachen Weg von JPEG-Dateien zu professionellen PDF-Dokumenten in C#. Die API verarbeitet einzelne Bilder und Stapelverarbeitungen mit demselben Methodenaufruf, unterstützt sieben Bildformate ohne zusätzlichen Code und integriert sich in den gesamten Funktionsumfang der PDF-Bearbeitung von IronPDF.
Beginnen Sie mit der Installation des Pakets über NuGet:
Passen Sie anschließend die Codebeispiele aus diesem Tutorial an Ihren Anwendungsfall an. Die Konvertierung eines einzelnen Bildes funktioniert mit drei Codezeilen. Für die Stapelverarbeitung werden eine LINQ-Abfrage und ein Methodenaufruf benötigt. Die Layoutanpassung verwendet die ImageToPdfRenderOptions-Klasse mit der ImageBehavior-Enumeration.
Mit der kostenlosen Testversion von IronPDF erhalten Sie vollen Zugriff auf alle Funktionen zur Evaluierung. Wenn Sie bereit für die Produktion sind, prüfen Sie die Lizenzierungsoptionen für kommerzielle Anwendungen, einschließlich der Möglichkeiten zur Lizenzerweiterung für wachsende Teams. Die IronPDF PDF Converter-Funktionsseite listet alle unterstützten Konvertierungstypen auf, falls Sie mehr als nur JPEG-Eingaben verarbeiten müssen.
Für verwandte Bild-zu-Dokument-Workflows beschreibt der Leitfaden "Bilder zu PDFs hinzufügen" das Einbetten von Bildern in bestehende PDF-Seiten, und das Tutorial "HTML zu PDF" erklärt, wie man PDFs aus HTML-Vorlagen generiert, die Text und Bilder in einem einzigen Dokument kombinieren.
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.
IronPDF ist ein Teil der IRONSUITE
10 .NET-API-Produkte für Ihre Bürodokumente
Wenn Ihr PDF wie HTML aussehen soll, schnell.
