Bild in PDF umwandeln mit C# — Einzelne und mehrere Bilder

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?

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.

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

Wie konvertiere ich mehrere Bilder in PDF?

Um mehrere Bilder in ein PDF-Dokument zu konvertieren, geben Sie ein IEnumerable- Objekt an, das Dateipfade enthält, anstatt eines einzelnen Dateipfads. 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.

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

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 befindet sich in der oberen linken Ecke der Seite.
• TopRightCornerOfPage: Das Bild befindet sich in der oberen rechten Ecke der Seite.
• CenteredOnPage: Das Bild ist auf der Seite zentriert.
• FitToPageAndMaintainAspectRatio: Das Bild passt sich der Seite an und behält dabei sein ursprüngliches Seitenverhältnis bei.
• BottomLeftCornerOfPage: Das Bild befindet sich in der unteren linken Ecke der Seite.
• BottomRightCornerOfPage: Das Bild befindet sich in der unteren rechten Ecke der Seite.
• FitToPage: Bild passt auf die Seite.
• CropPage: Die Seite wurde 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.

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

Was sind die visuellen Unterschiede zwischen Image Behaviors?

`TopLeftCornerOfPage`	`TopRightCornerOfPage`
`ZentrierteSeite`	`FitToPageAndMaintainAspectRatio`
`BottomLeftCornerOfPage`	`BottomRightCornerOfPage`
`FitToPage`	`CropPage`

---

Wie kann ich die PDF-Rendering-Optionen anpassen?

Die statische Methode ImageToPdf konvertiert Bilder, indem sie diese als HTML-Tags <img> importiert und anschließend 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.

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