Wie man Bilder in ein PDF in C# konvertiert

Bilder in C#35 in eine PDF-Datei konvertieren

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

IronPDF ermöglicht C#-Entwicklern die Konvertierung einzelner oder mehrerer Bilder (JPG, PNG, TIFF) in PDF-Dokumente mithilfe der Methode ImageToPdfConverter.ImageToPdf mit anpassbarem Platzierungsverhalten und Rendering-Optionen.

Bei der Konvertierung von Bildern in PDF werden mehrere Bilddateien (z. B. JPG, PNG oder TIFF) in einem einzigen PDF-Dokument kombiniert. Mit diesem Prozess werden digitale Portfolios, Präsentationen oder Berichte erstellt, die die gemeinsame Nutzung und Speicherung von Bildsammlungen in einem organisierten und allgemein lesbaren Format erleichtern.

IronPDF konvertiert einzelne oder mehrere Bilder in PDFs mit einzigartigen Bildplatzierungen und Verhaltensweisen. Dieses Verhalten umfasst das Anpassen an die Seite, Zentrieren auf der Seite und Zuschneiden der Seite. Zusätzlich können Sie Text- und HTML-Kopf- und Fußzeilen mit IronPDF hinzufügen, Wasserzeichen mit IronPDF anwenden, benutzerdefinierte Seitengrößen einstellen und Hintergrund- sowie Vordergrundüberlagerungen einfügen.

Schnellstart: Bilder mit IronPDF in PDF umwandeln

Konvertieren Sie Bilder in PDF-Dokumente mit der Klasse ImageToPdfConverter von IronPDF. Dieses Beispiel zeigt, wie eine Bilddatei in eine PDF-Datei umgewandelt werden kann, so dass Sie die Bild-zu-PDF-Funktionalität in Ihre .NET C#-Anwendungen integrieren können. Mit minimalem Code können Sie Bilder in PDF konvertieren, um digitale Portfolios oder Berichte zu erstellen.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    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 mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer


Wie konvertiere ich ein einzelnes Bild in PDF?

Verwenden Sie die statische Methode ImageToPdf innerhalb der Klasse ImageToPdfConverter, um ein Bild in ein PDF-Dokument zu konvertieren. Diese Methode erfordert nur den Dateipfad zum Bild und konvertiert es in ein PDF-Dokument mit Standardbildplatzierung und -verhalten. Unterstützte Bildformate sind .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp und .pjpeg.

Bevor Sie beginnen, stellen Sie sicher, dass Sie IronPDF über NuGet installiert oder das Windows-Installationsprogramm heruntergeladen haben. Die Bibliothek funktioniert nahtlos auf den Plattformen Windows, macOS und Linux und ist somit vielseitig für verschiedene Entwicklungsumgebungen einsetzbar.

Welche Bildformate werden unterstützt?

IronSoftware Teammitglieder in lila Uniformen bei Firmenveranstaltung

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

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");
$vbLabelText   $csharpLabel

Für fortgeschrittene Szenarien können Sie die asynchrone PDF-Erzeugung erkunden, um die Leistung bei der Verarbeitung mehrerer Bilder zu verbessern. Die Bibliothek unterstützt auch angepasste Papiergrößen und angepasste Ränder, um sicherzustellen, dass Ihre Bilder genau wie gewünscht angezeigt werden.

Wie sieht die Ausgabe aus?


Wie konvertiere ich mehrere Bilder in PDF?

Um mehrere Bilder in ein PDF-Dokument zu konvertieren, geben Sie ein IEnumerable-Objekt an, das Dateipfade anstelle eines einzelnen Dateipfads enthält. Es wird ein PDF-Dokument mit Standardbildplatzierung und -verhalten erstellt.

Wenn Sie mit mehreren Bildern arbeiten, sollten Sie die PDF-Komprimierungsoptionen berücksichtigen, die zur Optimierung der Dateigröße ohne Qualitätseinbußen zur Verfügung stehen. Dies ist besonders wichtig bei der Erstellung großer Portfolios oder Fotoalben.

Wie verarbeite ich mehrere Bilder auf einmal?

: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");
$vbLabelText   $csharpLabel

Wie sieht die Multi-Image-PDF 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 es unter Beibehaltung des Seitenverhältnisses an die Seitengröße anpassen. Alle verfügbaren Bildplatzierungen und Verhaltensweisen sind:

  • TopLeftCornerOfPage: Das Bild wird in der oberen linken Ecke der Seite platziert.
  • TopRightCornerOfPage: Das Bild wird in der oberen rechten Ecke der Seite platziert.
  • ZentriertaufderSeite: Das Bild ist auf der Seite zentriert.
  • FitToPageAndMaintainAspectRatio: Das Bild passt auf die Seite und behält sein ursprüngliches Seitenverhältnis bei.
  • BottomLeftCornerOfPage: Das Bild wird in der linken unteren Ecke der Seite platziert.
  • BottomRightCornerOfPage: Das Bild wird in der rechten unteren Ecke der Seite platziert.
  • FitToPage: Bild passt auf die Seite.
  • CropPage: Die Seite wird an das Bild angepasst.

Diese Platzierungsoptionen arbeiten nahtlos mit den IronPDF-Funktionen Seitenausrichtung und -drehung zusammen, so dass Sie unabhängig von Ihren Bildabmessungen professionell aussehende Dokumente erstellen können.

Wie wende ich Image Behaviors 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");
$vbLabelText   $csharpLabel

Was sind die visuellen Unterschiede zwischen Image Behaviors?

Iron Software Teammitglieder in lila Sportkleidung bei einer Teamveranstaltung des Unternehmens
Iron Software Teammitglieder in lila Sportkleidung bei einer Firmenveranstaltung im Freien
Iron Software Teammitglieder in lila Sportkleidung bei einer Teamveranstaltung des Unternehmens
IronSoftware-Teammitglieder in lila Uniformen bei einer Firmensportveranstaltung
Iron Software-Teammitglieder in lila Sportkleidung bei einer Firmensportveranstaltung mit dem Overlay
Iron Software-Teammitglieder in violetter Sportkleidung bei einer Sportveranstaltung des Unternehmens mit eingebranntem Text-Overlay
IronSoftware-Teammitglieder in lilafarbenen Uniformen bei einem Teamevent des Unternehmens mit einem Text-Overlay
Iron Software Teammitglieder in lila Sportkleidung bei einer Teamveranstaltung des Unternehmens

Wie kann ich die PDF-Rendering-Optionen anpassen?

Die statische Methode ImageToPdf konvertiert Bilder, indem sie sie als HTML <img>-Tags importiert und dann das HTML in PDF konvertiert. Dies ermöglicht es Ihnen, das ChromePdfRenderOptions-Objekt als dritten Parameter zu übergeben, um den Rendering-Prozess direkt anzupassen.

Dieser Ansatz bietet Zugang zu allen leistungsstarken Rendering-Optionen, die in IronPDF zur Verfügung stehen, einschließlich der Ausführung von JavaScript, CSS-Medientypen und der Konfiguration von Ansichtsfenstern. Sie können sogar Webfonts und Icons einbinden, um die visuelle Attraktivität Ihres Dokuments zu erhöhen.

Wie füge ich Kopfzeilen und benutzerdefiniertes Styling 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");
$vbLabelText   $csharpLabel

Für komplexere Anforderungen an Kopf- und Fußzeilen empfehlen wir Ihnen unseren umfassenden Leitfaden zu HTML-Kopf- und Fußzeilen . Sie können auch Seitenzahlen zu Ihren bildbasierten PDFs hinzufügen, um sie besser zu organisieren.

Wie sieht die angepasste Ausgabe aus?

Wie gehe ich mit Leistung und großen Bildsammlungen um?

Wenn Sie mit großen Bildsammlungen oder hochauflösenden Bildern arbeiten, sollten Sie async- und Multithreading-Techniken einsetzen, um die Leistung zu verbessern. Für Unternehmensanwendungen sollten Sie die Strategien zur Leistungsoptimierung von IronPDF kennenlernen, um einen reibungslosen Betrieb auch bei hohen Arbeitslasten zu gewährleisten.

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

Wie konvertiere ich PDFs zurück in Bilder?

Wie Sie ein PDF-Dokument in Bilder konvertieren oder rastern, erfahren Sie in unserem Leitfaden zum Rastern von PDFs in Bilder.

Bereit zu sehen, was Sie sonst noch tun können? Schauen Sie sich unsere Tutorial-Seite hier 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 17,012,929 | Version: 2025.12 gerade veröffentlicht