How to Print PDF Files in C#

PDF-Datei-Beispiel drucken

Die Print-Methode ist über das PdfDocument-Objekt verfügbar, sodass Sie sowohl neu erstellte als auch vorhandene PDF-Dateien drucken können. Standardmäßig verwendet die Methode den Standarddrucker des Systems, aber Sie können einen anderen Drucker angeben, indem Sie seinen Namen als Zeichenkette an die Print-Methode übergeben.

:path=/static-assets/pdf/content-code-examples/how-to/print-pdf-print.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Test printing</h1>");

// Send the document to "Microsoft Print to PDF" printer
pdf.Print("Microsoft Print to PDF");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Test printing</h1>")

' Send the document to "Microsoft Print to PDF" printer
pdf.Print("Microsoft Print to PDF")

class="content-img-align-center">

class="center-image-wrapper">

Druckerauflösung

Sie können die Auflösung des gedruckten PDFs angeben, indem Sie den gewünschten DPI-Wert an die Print-Methode übergeben, die den gleichen DPI sowohl für die horizontalen als auch für die vertikalen Abmessungen anwenden wird. Um unterschiedliche DPI-Werte zu verwenden, übergeben Sie zwei Parameter an die Methode: den ersten für den horizontalen (x) DPI und den zweiten für den vertikalen (y) DPI.

:path=/static-assets/pdf/content-code-examples/how-to/print-pdf-dpi.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Test printing</h1>");

// Set custom DPI
pdf.Print(300);

// Specify printing resolution
pdf.Print(10, 10, "Microsoft Print to PDF");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Test printing</h1>")

' Set custom DPI
pdf.Print(300)

' Specify printing resolution
pdf.Print(10, 10, "Microsoft Print to PDF")

Sehen wir uns an, wie man eine PDF-Datei im nächsten Beispiel rastert und druckt.

In Datei drucken

Die PrintToFile-Methode rastert PDF-Dokumente effizient, indem sie sie in Bitmap-Bilder (pixelbasiert) umwandelt und als PDF-Datei speichert. Dieser Prozess wird vom integrierten Windows-Drucker gehandhabt, wie z. B. "Microsoft Print to PDF". Bemerkenswert ist, dass diese Methode die PDF-Datei auf der Festplatte speichert, ohne sie an einen physischen Drucker zu senden.

:path=/static-assets/pdf/content-code-examples/how-to/print-pdf-print-to-file.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Test printing</h1>");

// Print to file
pdf.PrintToFile("");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Test printing</h1>")

' Print to file
pdf.PrintToFile("")

Erkundung der Druck-PDF-Dokumenteinstellungen

Um Druckoptionen anzupassen, verwenden Sie die GetPrintDocument-Methode, die Microsoft PrinterSettings- und PrintController-Objekte akzeptiert. Diese Methode gibt das aktuelle Druckdokument-Objekt zurück. Die PrinterSettings ermöglichen es Ihnen, Optionen wie Seitenbereich und Druckerauswahl zu konfigurieren, während der PrintController die Kontrolle über den Druckprozess ermöglicht, einschließlich der Handhabung von Ausnahmen, Fortschrittsberichten, Druckdialogs, Druckvorschau und anderen verwandten Aufgaben. Ausführliche Beschreibungen der Optionen von PrinterSettings sind unten im Codebeispiel angegeben.

:path=/static-assets/pdf/content-code-examples/how-to/print-pdf-printer-setting.cs

using IronPdf;
using System.Drawing.Printing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Testing</h1>");

PrinterSettings settings = new PrinterSettings() {
    PrinterName = "Microsoft Print to PDF",

    // Number of Copy
    Copies = 2,

    // Page range to print
    FromPage = 2,
    ToPage = 4,
};

PrintDocument document = pdf.GetPrintDocument(settings);

// Print
document.Print();

Imports IronPdf
Imports System.Drawing.Printing

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Testing</h1>")

Private settings As New PrinterSettings() With {
	.PrinterName = "Microsoft Print to PDF",
	.Copies = 2,
	.FromPage = 2,
	.ToPage = 4
}

Private document As PrintDocument = pdf.GetPrintDocument(settings)

' Print
document.Print()

• CanDuplex: Gibt an, ob der Drucker Duplexdruck (beidseitiger Druck) unterstützt. Wenn wahr, ist das Drucken auf beiden Seiten des Papiers möglich; ansonsten ist es nicht möglich.
• Collate: Gibt an, ob mehrere PDF-Dateien oder Kopien eines PDF-Dokuments beim Drucken geordnet werden sollen. Wenn wahr, sortiert der Drucker die Kopien; wenn falsch, sortiert er sie nicht.
• Copies: Legt die Anzahl der zu druckenden Kopien des PDF-Dokuments fest. Es bestimmt, wie viele identische Kopien des Dokuments gedruckt werden.
• DefaultPageSettings: Repräsentiert die Standardseiten-Einstellungen für den Drucker, einschließlich Papiergröße, Ränder und Ausrichtung.
• Duplex: Gibt den Duplexdruck-Modus an, der verwendet werden soll. Optionen sind Duplex.Default, Duplex.Simplex (einseitig), Duplex.Horizontal und Duplex.Vertical.
• InstalledPrinters: Bietet eine Sammlung von auf dem System installierten Druckernamen. Sie können diese Sammlung durchlaufen, um die Namen der verfügbaren Drucker zu erhalten.
• IsDefaultPrinter: Gibt an, ob der in PrinterName angegebene Drucker als Standarddrucker auf dem System festgelegt ist.
• IsPlotter: Bestimmt, ob der Drucker ein Plotter ist. Plotter-Drucker werden oft für den Großformatdruck verwendet, wie z. B. für Architektur- oder Ingenieurzeichnungen.
• IsValid: Gibt an, ob die Druckereinstellungen gültig sind und für den Druck von PDF-Dateien verwendet werden können.
• LandscapeAngle: Gibt den Winkel (Drehung) der Querformat-Ausrichtung für den Drucker an, normalerweise 90 Grad für Hochformat.
• MaximumCopies: Repräsentiert die maximale Anzahl von Kopien, die für das Drucken von PDF angegeben werden können.
• MaximumPage: Gibt die maximale Seitennummer an, die für das Drucken oder die Konvertierung festgelegt werden kann.
• MinimumPage: Gibt die minimale Seitennummer an, die für das Drucken oder die Konvertierung festgelegt werden kann.
• PaperSizes: Bietet eine Sammlung von unterstützten Papierformaten für den Drucker. Sie können diese Sammlung abfragen, um verfügbare Papierformate zu bestimmen.
• PaperSources: Bietet eine Sammlung von verfügbaren Papierquellen oder -fächern für den Drucker. Dies kann nützlich sein, wenn Sie die Papierquelle für das Drucken von PDF-Dateien auswählen möchten.
• PrinterName: Gibt den Namen des Druckers an, der für das Drucken oder die Konvertierung verwendet werden soll.
• PrinterResolutions: Bietet eine Sammlung von verfügbaren Druckerauflösungen, sodass Sie die Druckqualität wählen können.
• PrintFileName: Ruft den Dateinamen beim Drucken in eine Datei mit PrintToFile ab oder legt ihn fest.
• PrintRange: Gibt den Bereich der zu druckenden PDF-Seiten an, wie z. B. alle Seiten, einen bestimmten Bereich oder eine Auswahl. Verwenden Sie dies, um bestimmte Seiten zu drucken.
• FromPage: Gibt die Startseitennummer für das Drucken oder die Konvertierung an. Der Druck beginnt mit dieser Seite.
• ToPage: Gibt die Endseitennummer für das Drucken oder die Konvertierung an. Der Druck stoppt, nachdem diese Seite erreicht wurde.
• PrintToFile: Gibt an, ob in eine Datei statt auf einen physischen Drucker gedruckt werden soll. Wenn wahr, können Sie den Dateipfad mit PrintFileName angeben.
• SupportsColor: Gibt an, ob der Drucker Farbdruck unterstützt. Wenn wahr, wird der Farbdruck unterstützt; anderenfalls ist er auf Schwarzweiß (monochrom) beschränkt.

Um schließlich den Standarddrucker zum Drucken von PDFs zu konfigurieren, können Sie den Abschnitt "Drucker & Scanner" der Maschineinstellungen aufrufen.