1. IronPrint
  2. Anleitungen
  3. Druckeinstellungen
Wie man Druckeinstellungen in PDF mit C# konfiguriert | IronPrint

Mit IronPrint Druckeinstellungen in C#35; konfigurieren

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

Konfigurieren Sie die Druckeinstellungen in C# mit der Klasse PrintSettings von IronPrint, um Papiergröße, Ausrichtung, DPI, Ränder und mehr zu steuern. Instanzieren Sie einfach PrintSettings, legen Sie Ihre Einstellungen fest und übergeben Sie es an die Methode Print.

Schnellstart: Konfigurieren und Drucken mit IronPrint-Einstellungen

Beginnen Sie mit der Erstellung eines PrintSettings-Objekts und legen Sie Eigenschaften wie Papiergröße, Ausrichtung, DPI, Kopien und Graustufen fest. Rufen Sie dann Printer.Print(...) auf, um diese Einstellungen sofort anzuwenden — keine komplizierte Einrichtung erforderlich.

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

  1. Installieren Sie IronPrint mit dem NuGet-Paketmanager.

    PM > Install-Package IronPrint

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronPrint.Printer.Print("document.pdf", new IronPrint.PrintSettings { PaperSize = IronPrint.PaperSize.A4, PaperOrientation = IronPrint.PaperOrientation.Landscape, Dpi = 300, NumberOfCopies = 2, Grayscale = true });

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPrint in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Laden Sie eine C#-Bibliothek zum Konfigurieren der Druckeinstellungen herunter.
  2. Instanziieren Sie die PrintSettings Klasse
  3. Konfigurieren Sie das PrintSettings Objekt nach Ihren Wünschen
  4. Übergeben Sie es an die Methode Print oder ShowPrintDialog .
  5. Überprüfen Sie das gedruckte PDF-Dokument und sehen Sie, dass die Druckeinstellungen angewendet wurden

Wie lege ich Druckeinstellungen fest?

Um die Druckeinstellungen zu konfigurieren, instanziieren Sie die Klasse PrintSettings und konfigurieren sie nach Ihren Wünschen. In den Methoden Print oder ShowPrintDialog übergeben Sie das Objekt PrintSettings als zweiten Parameter. Das folgende Codebeispiel veranschaulicht diese Verwendung. Ausführlichere Beispiele finden Sie auf der Seite Codebeispiele für Druckeinstellungen.

// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);
// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);
' Import the necessary namespace for IronPrint
Imports IronPrint

' Initialize a new instance of the PrintSettings class
Private settings As New PrintSettings()

' Configure various print settings
settings.PaperSize = PaperSize.A4 ' Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape ' Set paper orientation to Landscape
settings.Dpi = 300 ' Set print resolution to 300 DPI
settings.NumberOfCopies = 2 ' Set the number of copies to 2
settings.PrinterName = "MyPrinter" ' Set the name of the printer
settings.PaperMargins = New Margins(10, 10, 10, 10) ' Set margins to 10mm on each side
settings.Grayscale = True ' Print in grayscale

' Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings)
$vbLabelText   $csharpLabel

Warum muss ich die Druckeinstellungen konfigurieren?

Eine Druckeinstellung bezieht sich auf eine Konfiguration oder eine Reihe von Parametern, die festlegen, wie ein Dokument oder Inhalt gedruckt werden soll. Zu diesen Einstellungen gehören Details wie Papierformat, Ausrichtung (Hoch- oder Querformat), Druckauflösung (Dots per Inch - DPI), Anzahl der Kopien, Druckerauswahl, Ränder und Optionen wie Graustufendruck. Passen Sie diese Einstellungen an, um bestimmte Druckvorlieben und Anforderungen zu erfüllen.

Die umfassenden Druckeinstellungen von IronPrint bieten Entwicklern eine detaillierte Kontrolle über jeden Aspekt des Druckprozesses. Ob bei der Erstellung von Desktop-Anwendungen oder ASP.NET-Webanwendungen, die richtige Konfiguration gewährleistet konsistente Ergebnisse in verschiedenen Umgebungen.

Wann sollte ich benutzerdefinierte Druckeinstellungen verwenden?

Benutzerdefinierte Druckeinstellungen sind unerlässlich, wenn eine genaue Kontrolle über die Druckausgabe erforderlich ist, z. B. beim Drucken von Berichten mit bestimmten Rändern, beim Erstellen mehrerer Kopien von Dokumenten oder beim Sicherstellen, dass Dokumente in der richtigen Ausrichtung für geschäftliche Anforderungen gedruckt werden.

Hier ist ein praktisches Beispiel für den Druck von Rechnungen mit spezifischen Anforderungen:

// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);
// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Was passiert, wenn ich keine Druckeinstellungen vornehme?

Wenn keine Druckeinstellungen angegeben sind, verwendet IronPrint die Standardeinstellungen des Standarddruckers Ihres Systems, die möglicherweise nicht dem gewünschten Ausgabeformat oder den Qualitätsanforderungen entsprechen. Um die auf Ihrem System verfügbaren Drucker zu ermitteln, verwenden Sie die Methode GetPrinterNames, um alle angeschlossenen Drucker programmatisch abzurufen.

Welche Druckeinstellungen sind verfügbar?

Sehen Sie sich unten alle verfügbaren Optionen für die Druckeinstellungen an. Die vollständige API-Referenz bietet eine detaillierte Dokumentation für jede Eigenschaft und Methode:

Einstellung Beschreibung Standardwert Bemerkungen
StandardEinstellungen Initialisiert eine neue Instanz der IronPrint.PrintSettings-Klasse mit Standardwerten Nicht anwendbar Nicht anwendbar
Papiergröße Legt das vom Drucker verwendete Papierformat fest IronPrint.PaperSize.PrinterDefault Nicht anwendbar
Papierausrichtung Gibt die Papierausrichtung an (z. B. Hoch- oder Querformat) IronPrint.PaperOrientation.Portrait Nicht anwendbar
Dpi Stellt die vorgesehene Druckauflösung in Dots per Inch dar 300 Die tatsächliche DPI, die für den Druck verwendet wird, kann durch die Fähigkeiten des Druckers begrenzt sein
Anzahl der Exemplare Gibt die Anzahl der identischen Kopien an, die beim Drucken eines Dokuments erzeugt werden sollen 1 Bei bestimmten Plattformen kann es Einschränkungen geben, die eine genaue Wiedergabe von Mehrfachkopien verhindern. In solchen Fällen kann der angegebene Wert von IronPrint.PrintSettings.NumberOfCopies ignoriert werden, was dazu führt, dass nur eine Kopie gedruckt wird
Druckername Gibt den Namen des Druckers an, der zum Drucken verwendet werden soll null (verwendet den Standarddrucker des Betriebssystems) Wenn Sie den Drucker in einem PrintDialog auswählen, wird diese Einstellung ignoriert. Um die verfügbaren Druckernamen zu erhalten, können Sie IronPrint.Printer.GetPrinterNames oder IronPrint.Printer.GetPrinterNamesAsync verwenden, um die Liste der Druckernamen abzurufen
PaperMargins Legt die zu verwendenden Ränder für den Druck in Millimetern fest null (verwendet die Standardränder des Druckers) Nicht anwendbar
Graustufen Gibt an, ob in Graustufen gedruckt werden soll falsch (versucht Farbdruck) Nicht anwendbar
Flatten Die PDF-Datei wird vor dem Druck geglättet, was für die Anzeige von Formularfeldwerten und Bildern nützlich ist falsch Nicht anwendbar
Tray Der für den Druckauftrag verwendete Druckerschacht. Damit können Benutzer ein bestimmtes Fach angeben, aus dem das Papier in den Drucker eingezogen werden soll null (verwendet das Standardfach des Druckers) Wenn Sie das Fach in einem PrintDialog auswählen, wird diese Einstellung ignoriert. Um das verfügbare Fach zu erhalten, können Sie IronPrint.Printer.GetPrinterTrays(System.String) oder IronPrint.Printer.GetPrinterTraysAsync(System.String) verwenden. Diese Eigenschaft der Tray-Auswahl ist nur in Windows verfügbar

Welche Druckeinstellungen sollte ich immer konfigurieren?

Für die meisten Geschäftsanwendungen sollten Sie immer PaperSize, PaperOrientation und Dpi konfigurieren, um eine einheitliche Ausgabe auf verschiedenen Druckern und Systemen zu gewährleisten. Diese drei Einstellungen haben den größten Einfluss auf das Erscheinungsbild und die Lesbarkeit des Dokuments.

Wenn Sie mit dialogbasiertem Drucken arbeiten, kombinieren Sie benutzerdefinierte Einstellungen mit Benutzerinteraktion unter Verwendung der ShowPrintDialog-Methode:

// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);
// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Wie gehe ich mit plattformspezifischen Einstellungen um?

Einige Einstellungen wie die Auswahl der Ablage sind nur unter Windows verfügbar. Überprüfen Sie immer die Plattformkompatibilität, wenn Sie plattformspezifische Funktionen verwenden, und stellen Sie ein Fallback-Verhalten für plattformübergreifende Anwendungen bereit. Für die Behebung von plattformspezifischen Problemen konsultieren Sie bitte den engineering support guide.

Was sind gängige Kombinationen von Druckeinstellungen?

Übliche Kombinationen sind A4/Portrait/300 DPI für Standarddokumente, A3/Landscape/600 DPI für detaillierte Berichte und Letter/Portrait/300 DPI/Graustufen für Entwurfsdrucke, um Tinte zu sparen.

Hier ist ein Beispiel, das verschiedene Szenarien zeigt:

// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};
// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Umfassendere Beispiele und fortgeschrittene Druckszenarien finden Sie im Tutorial zum Drucken von Dokumenten, das den gesamten Druckworkflow von Anfang bis Ende abdeckt.

Bei der Implementierung von Druckeinstellungen in Produktionsumgebungen, insbesondere in Webanwendungen, die Web.config verwenden, sollten Sie den Leitfaden zum Setzen von Lizenzschlüsseln in Web.config lesen, um eine korrekte Konfiguration sicherzustellen.

Häufig gestellte Fragen

Wie konfiguriere ich Druckeinstellungen in C#?

Um Druckeinstellungen in C# zu konfigurieren, instanziieren Sie die PrintSettings-Klasse von IronPrint und legen Eigenschaften wie PaperSize, PaperOrientation, Dpi, NumberOfCopies und Grayscale fest. Dann übergeben Sie dieses PrintSettings-Objekt als zweiten Parameter an die Methoden Print oder ShowPrintDialog.

Welche Druckeinstellungen kann ich anpassen?

Mit der PrintSettings-Klasse von IronPrint können Sie das Papierformat (A4, Letter usw.), die Ausrichtung (Hochformat/Landschaft), die DPI-Auflösung, die Anzahl der Kopien, die Druckerauswahl, die Papierränder und die Graustufen-Druckoptionen anpassen.

Wie stelle ich Papiergröße und -ausrichtung ein?

Legen Sie die Papiergröße mit der Eigenschaft PaperSize (z. B. PaperSize.A4) und die Ausrichtung mit der Eigenschaft PaperOrientation (z. B. PaperOrientation.Landscape) im IronPrint PrintSettings-Objekt fest, bevor Sie die Methode Print aufrufen.

Kann ich mehrere Kopien eines Dokuments ausdrucken?

Ja, Sie können mehrere Kopien drucken, indem Sie die Eigenschaft NumberOfCopies in der PrintSettings-Klasse festlegen. Mit settings.NumberOfCopies = 2 werden zum Beispiel zwei Kopien Ihres Dokuments mit IronPrint gedruckt.

Wie kann ich benutzerdefinierte Ränder für den Druck festlegen?

Legen Sie benutzerdefinierte Ränder mithilfe der PaperMargins-Eigenschaft in PrintSettings mit der Margins-Klasse fest. Beispiel: settings.PaperMargins = new Margins(10, 10, 10, 10) legt beim Drucken mit IronPrint 10 mm Ränder an allen Seiten fest.

Kann ich in Graustufen statt in Farbe drucken?

Ja, aktivieren Sie den Graustufendruck, indem Sie die Eigenschaft Grayscale im PrintSettings-Objekt auf true setzen. Dadurch werden Farbdokumente beim Drucken über IronPrint in Graustufen umgewandelt.

Chaknith Bin
Chaknith Bin
  Jetzt mit dem Ingenieurteam chatten
Software Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat umfassende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Einblicke aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentationen und einem insgesamt besseren Erlebnis bei.
Bereit anzufangen?
Nuget Downloads 35,444 | Version: 2025.12 gerade veröffentlicht