Papiergröße einstellen zum PDF drucken in C

Wie stelle ich die Papiergröße beim Drucken in C# ein?

Wir stellen die Papiergröße ein, indem wir einen Wert aus der PaperSize-Enum der PaperSize-Eigenschaft eines PrintSettings-Objekts zuweisen. Wir übergeben dann dieses Objekt an eine der Druckmethoden von IronPrint.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Send the document to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Send the document to the default printer
Printer.Print("invoice.pdf", settings)

Wir instanziieren zunächst PrintSettings, welches mit den Druckereinstellungen initialisiert wird. Dann überschreiben wir PaperSize mit PaperSize.Letter, welches dem Standardformular 8,5 × 11 Zoll entspricht. Wenn wir Printer.Print aufrufen, sendet IronPrint das Dokument an den Standarddrucker des Systems unter Verwendung dieser Papiergröße.

Wenn keine PaperSize angegeben ist, verwendet IronPrint PaperSize.PrinterDefault, welches sich darauf verlässt, welche Papiergröße der Standarddrucker des Betriebssystems verwenden soll. Dies ist ein wesentliches Detail für Produktionsumgebungen, in denen Druckerkonfigurationen auf verschiedenen Maschinen variieren.

Welche Papiergrößen unterstützt die Bibliothek?

Die PaperSize-Enum enthält zwölf Werte, die ISO-Internationale Standards, gebräuchliche US-Größen und die Druckervoreinstellung abdecken. Die folgende Tabelle listet alle verfügbaren Optionen auf.

Jeder Wert entspricht direkt einem bekannten Papierstandard. Die PrinterDefault-Option sagt IronPrint, dass die aktuelle Druckerkonfiguration genutzt werden soll – nützlich, wenn man Nutzereinstellungen respektieren möchte, anstatt ein spezifisches Format zu erzwingen.

Für eine vollständige API-Referenz, siehe die Dokumentation der PaperSize-Klasse.

Wie kombiniere ich Papiergröße mit anderen Druckeinstellungen?

Die PrintSettings-Klasse stellt mehrere Eigenschaften über die PaperSize hinaus zur Verfügung. Wir können die Ausrichtung, DPI, Ränder, Kopienanzahl und Graustufenmodus konfigurieren – alles in einem Objekt.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Build a fully configured print job
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print a multi-page report with these settings
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Build a fully configured print job
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print a multi-page report with these settings
Printer.Print("quarterly-report.pdf", settings)

Wir verwenden hier die Syntax des Objektinitialisierers zur Klarheit. PaperOrientation.Landscape dreht das A4-Blatt auf seine breitere Achse. Dpi bei 300 gewährleistet scharfe Ausgaben für Diagramme und feine Texte. PaperMargins akzeptiert vier Werte in Millimetern – oben, rechts, unten, links – durch den Margins-Konstruktor. Die Grayscale-Eigenschaft standardmäßig auf false gesetzt, aber wir setzen es explizit zur besseren Lesbarkeit.

Diese Eigenschaften arbeiten konfliktfrei zusammen. IronPrint überprüft die Konfiguration und übergibt die kombinierten Einstellungen als Einzelauftrag an den Druckertreiber. Für weitere, fortgeschrittene Einstellungen wie Druckerauswahl und Schachtkonfiguration, sehen Sie sich den vollständigen Druckeinstellungen-Guide an.

Wie drucke ich asynchron mit einer benutzerdefinierten Papiergröße?

Für Anwendungen, bei denen das Blockieren des Hauptthreads keine Option ist – wie in WPF- oder WinForms-Apps – verwenden wir Printer.PrintAsync. Die Methode akzeptiert dasselbe PrintSettings-Objekt und gibt ein Task zurück.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size for contracts and legal documents
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print without blocking the UI thread
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size for contracts and legal documents
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print without blocking the UI thread
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Dieses klassenbasierte Beispiel demonstriert ein realistisches Muster, bei dem ein DocumentPrinter-Dienst die Drucklogik umschließt. Wir konfigurieren PaperSize.Legal (8,5 × 14 Zoll), welches das Standardformat für Verträge und rechtliche Einreichungen ist. Das await-Schlüsselwort gewährleistet, dass der aufrufende Thread reaktionsfähig bleibt, während IronPrint den Druckauftrag verarbeitet.

Wir können diese Methode von einem Button-Click-Handler, einem Hintergrunddienst oder überall dort aufrufen, wo await unterstützt wird. IronPrints asynchrone Methoden – einschließlich PrintAsync und ShowPrintDialogAsync – akzeptieren dieselbe PrintSettings-Konfiguration, sodass das Verhalten der Papiergröße zwischen synchronen und asynchronen Pfaden identisch ist.

Was sind meine nächsten Schritte?

Wir haben behandelt, wie man die Papiergröße in C# mit der PaperSize-Enum von IronPrint einstellt, von der grundlegenden Einstellweise bis hin zu kombinierten Einstellungen und asynchronem Drucken. Die PrintSettings-Klasse bietet eine klare, stark typisierte API, die Rätselraten bei Papierabmessungen eliminiert.

Um IronPrints Fähigkeiten weiter zu erkunden:

• Lernen Sie, wie Sie alle Druckeinstellungen konfigurieren inklusive Druckername, Schacht und Graustufen
• Sehen Sie funktionsfähige Druckeinstellungscode-Beispiele für häufige Szenarien
• Durchsuchen Sie die vollständige API-Referenz für Klassen wie Printer, PrintSettings und PaperSize

Starten Sie eine kostenlose 30-Tage-Testversion, um die Papiergrößenkonfiguration in Ihren eigenen Projekten zu testen, oder erfahren Sie mehr über Lizenzierungsoptionen für die Produktionseinführung.