JPEG in PDF konvertieren .NET | IronPDF C# Tutorial

Wie installiert man IronPDF zur JPEG-zu-PDF-Konvertierung?

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:

Install-Package IronPdf

Install-Package IronPdf

Oder verwenden Sie die .NET-CLI:

dotnet add package IronPdf

dotnet add package IronPdf

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.

Nach der Installation fügen Sie am Anfang Ihrer Datei eine einzelne using IronPdf; Anweisung ein, und schon können Sie mit der Konvertierung 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.

Wie konvertiert man ein einzelnes JPEG-Bild in C# in ein PDF?

Der einfachste Weg zur JPEG-zu-PDF-Konvertierung verwendet die statische Methode ImageToPdfConverter.ImageToPdf(). Übergeben Sie den Pfad zur Bilddatei, erhalten Sie ein PdfDocument-Objekt und speichern Sie es an dem gewünschten Ort.

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");

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.

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");

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")

Wie wandelt man mehrere JPEG-Dateien in ein einziges PDF-Dokument um?

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 einer eigenen Seite in der Ausgabe.

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");

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.

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");

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")

Welche Bildformate unterstützt dieser PDF-Konverter?

Der Bild-zu-PDF-Konverter von IronPDF unterstützt neben JPEG eine breite Palette weiterer Formate. Die gleiche Klasse ImageToPdfConverter verarbeitet PNG-, BMP-, GIF-, TIFF-, SVG- und WebP-Dateien mit identischen Methodenaufrufen – Sie benötigen keine separaten Codepfade für verschiedene Bildtypen.

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.

Wie kann die Bildplatzierung im konvertierten PDF gesteuert werden?

Standardmäßig passt IronPDF die Größe der PDF-Seite an die Bildabmessungen an. Wenn Sie ein anderes Verhalten benötigen – z. B. Bilder an ein Standardpapierformat anpassen, sie mit weißen Rändern zentrieren oder sie so zuschneiden, dass sie die Seite ausfüllen – verwenden Sie die Aufzählung ImageBehavior in Kombination 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");

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 gängigsten Layoutanforderungen ab:

• FitToPageAndMaintainAspectRatio -- skaliert das Bild so, dass es die Seite ausfüllt und dabei die Proportionen beibehält
• CenteredOnPage -- platziert das Bild in seiner Originalgröße, horizontal und vertikal zentriert
• TopLeftCornerOfPage -- verankert das Bild oben links, ohne es zu skalieren
• CropPage -- passt die Seitengröße exakt an die Bildabmessungen an.

Nach 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:

• Stempeln von Text oder Bildern für Branding- oder Genehmigungszeichen
• Anwenden von Hintergrundvorlagen für Briefkopfeffekte
• Komprimierung der Ausgabe-PDF-Datei zur Reduzierung der Dateigröße für E-Mail oder Upload
• Zeichnen von Formen und Anmerkungen für visuelle Markierungen

Was sind die häufigsten Anwendungsfälle für die JPEG-zu-PDF-Konvertierung?

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. Durch das Einbetten dieser Daten in PDF-Berichte mit ImageToPdfConverter entstehen konsistente, druckbare Dokumente, die Stakeholder ohne Installation einer Diagrammsoftware einsehen können.

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, der von allen gängigen Browsern ohne Plugins nativ unterstützt wird – was PDF zur sichersten Formatwahl für Dokumente macht, die in einem Browser angezeigt werden müssen.

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.

Wie fügt man konvertierten PDFs Kopf- und Fußzeilen sowie Metadaten hinzu?

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");

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.

Was sind Ihre nächsten Schritte?

Die Klasse ImageToPdfConverter von IronPDF bietet Ihnen einen direkten Weg von JPEG-Dateien zu Professional 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:

Install-Package IronPdf

Install-Package IronPdf

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 Klasse ImageToPdfRenderOptions mit dem Enum ImageBehavior.

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.