Wie lege ich die Papiergröße für den Druck in C# fest

Wie lege ich die Papiergröße beim Drucken in C# fest?

Wir setzen die Papiergröße, indem wir einen Wert aus dem 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;

// Print 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

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

Zuerst instanziieren wir PrintSettings, das sich mit den Standardwerten des Druckers initialisiert. Anschließend überschreiben wir PaperSize mit PaperSize.Letter, das dem standardmäßigen Format 8,5 × 11 Zoll entspricht. Wenn wir Printer.Print aufrufen, sendet IronPrint das Dokument mit dieser Papiergröße an den Standarddrucker des Systems.

Wenn kein PaperSize angegeben ist, verwendet IronPrint PaperSize.PrinterDefault, das auf die Papiergröße verweist, die beim Standarddrucker des Betriebssystems konfiguriert ist. Dies ist ein wesentlicher Detail für Produktionsumgebungen, in denen Druckerkonfigurationen zwischen Maschinen variieren.

Welche Papiergrößen unterstützt die Bibliothek?

Das PaperSize-Enum umfasst zwölf Werte, die internationale ISO-Standards, gängige US-Größen und die Druckerstandardeinstellungen abdecken. Die folgende Tabelle listet jede verfügbare Option auf.

Jeder Wert entspricht direkt einem bekannten Papierstandard. Die PrinterDefault-Option veranlasst IronPrint, die aktuelle Druckergröße zu verwenden — nützlich, wenn Sie die Druckereinstellungen des Endbenutzers respektieren möchten, statt ein bestimmtes Format zu erzwingen.

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

Wie kombiniere ich die Papiergröße mit anderen Druckeinstellungen?

Die PrintSettings-Klasse stellt mehrere Eigenschaften jenseits von PaperSize bereit. Wir können Ausrichtung, DPI, Seitenrä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;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the quarterly report
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Configure full print settings
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 the quarterly report
Printer.Print("quarterly-report.pdf", settings)

Wir verwenden hier die Syntax zur Objektinitialisierung für Klarheit. Orientation dreht das A4-Blatt auf seine breitere Achse. DPI bei 300 stellt eine scharfe Ausgabe für Diagramme und feinen Text sicher. Margins akzeptiert vier Werte in Millimetern — oben, rechts, unten, links — durch den Margins-Konstruktor. Die CopyCount-Eigenschaft ist standardmäßig auf 1 gesetzt, wir setzen sie jedoch explizit zur besseren Lesbarkeit.

Diese Eigenschaften arbeiten konfliktfrei zusammen. IronPrint überprüft die Konfiguration und übergibt die kombinierten Einstellungen als einen Druckauftrag an den Druckertreiber. Für erweiterte Einstellungen wie Druckerauswahl und Fachkonfiguration beziehen Sie sich auf den gesamten Leitfaden für Druckeinstellungen.

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

Für Anwendungen, bei denen das Blockieren des Hauptthreads keine Option ist — wie bei 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
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        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
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Dieses klassenbasierte Beispiel zeigt ein realistisches Muster, bei dem ein DocumentPrinter-Dienst die Drucklogik umschließt. Wir konfigurieren PaperSize.Legal (8,5 × 14 Zoll), das Standardformat für Verträge und rechtliche Einreichungen. Das await-Schlüsselwort stellt sicher, dass der aufrufende Thread während der Verarbeitung des Druckauftrags durch IronPrint reaktionsfähig bleibt.

Wir können diese Methode aus einem Klick-Handler, einem Hintergrunddienst oder überall dort aufrufen, wo await unterstützt wird. Die asynchronen Methoden von IronPrint — 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 Sie die Papiergröße in C# mit dem PaperSize-Enum von IronPrint einstellen, von der grundlegenden Einzel-Eigenschafts-Konfiguration bis zu kombinierten Einstellungen und asynchronem Drucken. Die PrintSettings-Klasse bietet eine saubere, stark typisierte API, die das Rätselraten rund um Papierdimensionen eliminiert.

Um weiter IronPrints Fähigkeiten zu erkunden:

• Erfahren Sie, wie Sie alle Druckeinstellungen konfigurieren einschließlich Druckername, Fach und Graustufen
• Sehen Sie sich funktionierende Codebeispiele für Druckeinstellungen für gängige Szenarien an
• Durchsuchen Sie die vollständige API Referenz für Klassen wie Printer, PrintSettings, PaperSize

Starten Sie eine kostenlose 30-Tage-Testversion, um die Papiergrößenkonfiguration in Ihren eigenen Projekten zu testen, oder sehen Sie sich Lizenzierungsoptionen für die produktive Bereitstellung an.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false