Wie man Bilder in ein PDF in C# konvertiert

So konvertieren Sie Bilder in C# in eine PDF-Datei

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF ermöglicht es C#-Entwicklern, einzelne oder mehrere Bilder (JPG, PNG, TIFF) mithilfe der ImageToPdfConverter.ImageToPdf-Methode mit anpassbaren Platzierungsverhalten und Darstellungsoptionen in PDF-Dokumente zu konvertieren.

Das Konvertieren von Bildern in PDF fasst mehrere Bilddateien (wie JPG, PNG oder TIFF) zu einem einzigen PDF-Dokument zusammen. Dieser Prozess erstellt digitale Portfolios, Präsentationen oder Berichte und erleichtert so das Teilen und Speichern von Bildersammlungen in einem übersichtlichen und universell lesbaren Format.

IronPDF konvertiert einzelne oder mehrere Bilder in PDF-Dateien mit individuellen Bildplatzierungen und Verhaltensweisen. Zu diesen Funktionen gehören das Anpassen an die Seite, das Zentrieren auf der Seite und das Zuschneiden der Seite. Darüber hinaus können Sie mit IronPDF Text sowie HTML-Kopf- und Fußzeilen hinzufügen, Wasserzeichen einfügen, benutzerdefinierte Seitengrößen festlegen und Hintergrund- sowie Vordergrundüberlagerungen einfügen.

Schnellstart: Bilder mit IronPDF in PDF konvertieren

Konvertieren Sie Bilder mithilfe der ImageToPdfConverter-Klasse von IronPDF in PDF-Dokumente. Dieses Beispiel zeigt, wie Sie eine Bilddatei in ein PDF umwandeln können, sodass Sie die Bild-zu-PDF-Funktionalität in Ihre .NET-C#-Anwendungen integrieren können. Mit minimalem Code können Sie Bilder in PDF-Dateien konvertieren, um digitale Portfolios oder Berichte zu erstellen.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf
  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer


Wie konvertiere ich ein einzelnes Bild in ein PDF?

Verwenden Sie die statische Methode innerhalb der Klasse, um ein Bild in ein PDF-Dokument zu konvertieren. Diese Methode benötigt lediglich den Dateipfad zum Bild und konvertiert es in ein PDF-Dokument mit standardmäßiger Bildplatzierung und -darstellung. Zu den unterstützten Bildformaten gehören .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp und .pjpeg.

Stellen Sie vor dem Start sicher, dass Sie IronPDF über NuGet installiert oder den Windows-Installer heruntergeladen haben. Die Bibliothek funktioniert nahtlos auf Windows-, macOS- und Linux-Plattformen und ist somit vielseitig für verschiedene Entwicklungsumgebungen einsetzbar.

Welche Bildformate werden unterstützt?

Mitglieder des Iron Software-Teams in lila Uniformen bei einer Firmenveranstaltung

IronPDF unterstützt eine umfassende Palette an Bildformaten, darunter Rasterformate wie JPEG, PNG, BMP und GIF sowie Vektorformate wie SVG-Grafiken. Die Bibliothek unterstützt sowohl Standardformate als auch moderne Formate wie WebP und AVIF und gewährleistet so die Kompatibilität mit aktuellen Webanwendungen. Für spezielle Anforderungen arbeiten Sie mit Icon-Dateien (.ico) und Cursor-Dateien (.cur).

Wie schreibe ich den Code?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

Für komplexere Szenarien sollten Sie die asynchrone PDF-Erstellung in Betracht ziehen, um die Leistung bei der Verarbeitung mehrerer Bilder zu verbessern. Die Bibliothek unterstützt zudem benutzerdefinierte Papierformate und Ränder, um sicherzustellen, dass Ihre Bilder genau wie gewünscht angezeigt werden.

Wie sieht das Ergebnis aus?


Wie konvertiere ich mehrere Bilder in PDF?

Um mehrere Bilder in ein PDF-Dokument zu konvertieren, geben Sie ein ``-Objekt an, das Dateipfade enthält, anstatt einen einzelnen Dateipfad anzugeben. Dadurch wird ein PDF-Dokument mit standardmäßiger Bildplatzierung und -darstellung erstellt.

Wenn Sie mit mehreren Bildern arbeiten, sollten Sie die verfügbaren PDF-Komprimierungsoptionen in Betracht ziehen, um die Dateigröße zu optimieren, ohne dabei an Qualität einzubüßen. Dies ist besonders wichtig bei der Erstellung umfangreicher Portfolios oder Fotoalben.

Wie bearbeite ich mehrere Bilder gleichzeitig?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs
using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the PDF
pdf.SaveAs("imagesToPdf.pdf")
$vbLabelText   $csharpLabel

Wie sieht die PDF-Datei mit mehreren Bildern aus?


Wie kann ich die Platzierung und das Verhalten von Bildern steuern?

IronPDF bietet verschiedene Optionen für die Platzierung und das Verhalten von Bildern. Sie können das Bild auf der Seite zentrieren oder an die Seitengröße anpassen, wobei das Seitenverhältnis beibehalten werden soll. Alle verfügbaren Bildplatzierungen und -verhalten sind:

  • : Das Bild befindet sich in der oberen linken Ecke der Seite.
  • : Das Bild befindet sich in der oberen rechten Ecke der Seite.
  • : Das Bild ist auf der Seite zentriert.
  • : Das Bild wird an die Seite angepasst, wobei das ursprüngliche Seitenverhältnis beibehalten wird.
  • : Das Bild befindet sich in der unteren linken Ecke der Seite.
  • : Das Bild befindet sich in der rechten unteren Ecke der Seite.
  • : Bild passt auf die Seite.
  • : Die Seite wird an das Bild angepasst.

Diese Platzierungsoptionen lassen sich nahtlos mit den Funktionen für Seitenausrichtung und -drehung von IronPDF kombinieren, sodass Sie unabhängig von den Abmessungen Ihrer Bilder professionell aussehende Dokumente erstellen können.

Wie wende ich Bildverhalten im Code an?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs
using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF with image behavior of centered on page
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

Was sind die visuellen Unterschiede zwischen den Bildverhalten?

Mitglieder des Iron Software-Teams in lila Sportbekleidung mit Firmenlogo bei einer Firmenveranstaltung
Mitglieder des Iron Software-Teams in lila Sportbekleidung mit Markenlogo bei einer Firmenveranstaltung im Freien
Mitglieder des Iron Software-Teams in lila Sportbekleidung mit Firmenlogo bei einer Firmenveranstaltung
Mitglieder des Iron Software-Teams in lila Uniformen bei einer Firmen-Sportveranstaltung
Mitglieder des Iron Software-Teams in lila Sportbekleidung bei einer Firmen-Sportveranstaltung mit der Einblendung
Mitglieder des Iron Software-Teams in lila Sportbekleidung mit Markenlogo bei einer Firmen-Sportveranstaltung mit überlagertem Markentext
Mitglieder des Iron Software-Teams in lila Uniformen bei einer Firmenveranstaltung mit dem Text
Mitglieder des Iron Software-Teams in lila Sportbekleidung mit Firmenlogo bei einer Firmenveranstaltung

Wie passe ich die PDF-Rendering-Optionen an?

Die statische Methode konvertiert Bilder, indem sie diese als HTML-Tags-Tags importiert und anschließend das HTML in PDF konvertiert. Dadurch können Sie das Objekt `` als dritten Parameter übergeben, um den Rendering-Prozess direkt anzupassen.

Dieser Ansatz bietet Zugriff auf alle leistungsstarken Rendering-Optionen, die in IronPDF verfügbar sind, einschließlich JavaScript-Ausführung, CSS-Medientypen und Viewport-Konfiguration. Sie können sogar Webfonts und Symbole einbinden, um die visuelle Attraktivität Ihres Dokuments zu steigern.

Wie füge ich Überschriften und benutzerdefinierte Formatierungen hinzu?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

' Convert an image to a PDF with custom header
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, options:= options)

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")
$vbLabelText   $csharpLabel

Für komplexere Anforderungen an Kopf- und Fußzeilen lesen Sie unseren umfassenden Leitfaden zu HTML-Kopf- und Fußzeilen. Sie können Ihren bildbasierten PDF-Dateien zur besseren Übersichtlichkeit auch Seitenzahlen hinzufügen.

Wie sieht das angepasste Ergebnis aus?

Wie gehe ich mit der Leistung und großen Bildersammlungen um?

Bei der Arbeit mit großen Bildersammlungen oder hochauflösenden Bildern sollten Sie Asynchron- und Multithreading-Techniken einsetzen, um die Leistung zu verbessern. Für Enterprise-Anwendungen sollten Sie die Strategien zur Leistungsoptimierung von IronPDF kennenlernen, um einen reibungslosen Betrieb auch bei hoher Auslastung zu gewährleisten.

Wenn Sie mit Bildern arbeiten, die in Cloud-Diensten gespeichert sind, lesen Sie außerdem unseren Leitfaden zum Einbetten von Bildern aus Azure Blob Storage für eine nahtlose Cloud-Integration.

Wie konvertiere ich PDFs wieder in Bilder?

Um ein PDF-Dokument in Bilder zu konvertieren oder zu rastern, lesen Sie unseren Leitfaden zum Rastern von PDFs in Bilder.

Sind Sie bereit zu sehen, was Sie noch alles tun können? Schauen Sie sich hier unsere Tutorial-Seite an: PDFs konvertieren

Häufig gestellte Fragen

Welche Bildformate können in PDF konvertiert werden?

IronPDF unterstützt eine breite Palette von Bildformaten für die PDF-Konvertierung, darunter .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp und .pjpeg. Dazu gehören sowohl Rasterformate wie JPEG, PNG, BMP und GIF als auch Vektorformate wie SVG-Grafiken.

Wie konvertiere ich in C# ein einzelnes Bild in PDF?

Um ein einzelnes Bild mit IronPDF in PDF zu konvertieren, verwenden Sie die statische Methode ImageToPdf innerhalb der Klasse ImageToPdfConverter. Geben Sie einfach den Dateipfad zu Ihrem Bild an: IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf"). Diese einzeilige Lösung wandelt Ihr Bild in ein PDF-Dokument mit Standardplatzierung und -verhalten um.

Kann ich mehrere Bilder in ein einziges PDF-Dokument konvertieren?

Ja, IronPDF ermöglicht die Konvertierung mehrerer Bilder (JPG, PNG, TIFF) in ein einziges PDF-Dokument mithilfe der Methode ImageToPdfConverter.ImageToPdf. Dies ist ideal für die Erstellung von digitalen Portfolios, Präsentationen oder Berichten, bei denen Sie mehrere Bilddateien in einem organisierten, universell lesbaren PDF-Format zusammenfassen müssen.

Welche Anpassungsmöglichkeiten gibt es bei der Konvertierung von Bildern in PDF?

IronPDF bietet umfangreiche Anpassungsoptionen, darunter einzigartige Bildplatzierungen und Verhaltensweisen (Anpassen an die Seite, Zentrieren, Zuschneiden), das Hinzufügen von Text und HTML-Kopf- und Fußzeilen, das Anbringen von Wasserzeichen, das Festlegen benutzerdefinierter Seitengrößen und das Einfügen von Hintergrund- und Vordergrundüberlagerungen. Diese Funktionen ermöglichen es Ihnen, aus Ihren Bildern professionell aussehende PDF-Dokumente zu erstellen.

Welche Plattformen werden von der Funktion zur Konvertierung von Bildern in PDF unterstützt?

Die IronPDF-Konvertierung von Bildern in PDF funktioniert nahtlos auf Windows-, macOS- und Linux-Plattformen und ist somit vielseitig für verschiedene Entwicklungsumgebungen einsetzbar. Sie können es über NuGet installieren oder das Windows-Installationsprogramm herunterladen, um auf Ihrer bevorzugten Plattform loszulegen.

Wie kann ich die Platzierung von Bildern bei der Konvertierung in PDF kontrollieren?

IronPDF bietet einzigartige Bildplatzierungen und Verhaltensweisen, einschließlich der Anpassung an die Seite, der Zentrierung auf der Seite und des Beschneidens der Seite. Mit diesen Verhaltensmustern für den Bildexport können Sie genau steuern, wie Ihre Bilder im endgültigen PDF-Dokument erscheinen, und so eine professionelle Darstellung Ihrer visuellen Inhalte gewährleisten.

Curtis Chau
Technischer Autor

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 ...

Weiterlesen
Rezensiert von
Jeff Fritz
Jeffrey T. Fritz
Principal Program Manager - .NET Community Team
Jeff ist außerdem Principal Program Manager für das .NET- und Visual Studio-Team. Er ist der ausführende Produzent der .NET Conf Virtual Conference Series und moderiert ‚Fritz and Friends‘, einen Livestream für Entwickler, der zweimal wöchentlich ausgestrahlt wird. Dort spricht er über Technik und schreibt gemeinsam mit den Zuschauern Code. Jeff schreibt Workshops, Präsentationen und plant Inhalte für die größten Microsoft-Entwicklerveranstaltungen, einschließlich Microsoft Build, Microsoft Ignite, .NET Conf und dem Microsoft MVP Summit.
Bereit anzufangen?
Nuget Downloads 18,926,724 | Version: 2026.5 just released
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.