Wie lege ich den Druckernamen in C# fest?

Eingabe

invoice.pdf ist eine gestylte A4 B2B-Rechnung mit Posten und Gesamtsummen, gedruckt auf einen bestimmten benannten Drucker über PrintSettings.PrinterName.

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-set-printer-name.cs

using IronPrint;

// Configure print settings with a target printer
PrintSettings settings = new PrintSettings();
settings.PrinterName = "Microsoft Print to PDF";

// Print to the specified printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with a target printer
Dim settings As New PrintSettings()
settings.PrinterName = "Microsoft Print to PDF"

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

Zuerst instanziieren wir PrintSettings, das mit PrinterName = null initialisiert wird, was den Betriebssystem-Standarddrucker bedeutet. Dann überschreiben wir PrinterName mit dem genauen Zeichenkettennamen des Ziel-Druckers. Wenn wir Printer.Print aufrufen, schickt IronPrint den Auftrag direkt an die Warteschlange dieses Druckers.

Ausgabe

Die Rechnung wird direkt an den benannten Drucker gesendet. Der Auftrag erscheint in der Druckerwarteschlange, wie im Beispiel für leises Drucken zu sehen ist.

Rechnungsausgabe gedruckt auf "Microsoft Print to PDF" unter Verwendung von PrinterName.

Zwei Details, an die Sie denken sollten. Erstens, der Druckername muss exakt dem entsprechen, was das Betriebssystem meldet; Dieser Vergleich ist groß-/klein-schreibungssensitiv. Ein Fehler wie "hp laserjet" anstelle von "HP LaserJet" wird stumm scheitern oder einen Fehler erzeugen. Zweitens, wenn der Benutzer über ShowPrintDialog ein Druckdialog eröffnet, überschreibt die Dialogauswahl jegliche PrinterName, die im Code gesetzt wurden, was dem Benutzer die endgültige Kontrolle gibt.

Wenn der Druckername nicht im Voraus bekannt ist, können wir zur Laufzeit anstatt der harten Kodierung den Wert alle installierten Drucker abfragen.

Eingabe

report.pdf ist ein A4-Geschäftsbericht mit einem Abschnitt zur Zusammenfassung und einer Datentabelle, gedruckt auf den zuerst dynamisch entdeckten Drucker.

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-discover-printers.cs

using IronPrint;

// List every installed printer
List<string> printers = Printer.GetPrinterNames();

// Print each printer name
foreach (string name in printers)
{
    Console.WriteLine(name);
}

// Print to the first available printer
if (printers.Count > 0)
{
    Printer.Print("report.pdf", new PrintSettings
    {
        PrinterName = printers[0]
    });
}

Imports IronPrint

' List every installed printer
Dim printers As List(Of String) = Printer.GetPrinterNames()

' Print each printer name
For Each name As String In printers
    Console.WriteLine(name)
Next

' Print to the first available printer
If printers.Count > 0 Then
    Printer.Print("report.pdf", New PrintSettings With {
        .PrinterName = printers(0)
    })
End If

Wir rufen GetPrinterNames auf, um jeden Drucker zu erhalten, den das Betriebssystem kennt, einschließlich lokaler, Netzwerk- und virtueller Drucker wie 'Microsoft Print to PDF'. Dann iterieren wir durch die Liste und wählen einen Drucker nach Index, Namensübereinstimmung oder einer beliebigen benutzerdefinierten Logik, die die Anwendung erfordert.

Ausgabe

Der Bericht wird an den ersten verfügbaren Drucker gesendet. Der Auftrag erscheint in der Druckerwarteschlange wie oben zu sehen.

Berichtsausgabe gedruckt an den ersten verfügbaren Drucker über GetPrinterNames.

Dieses Erkennen-dann-Drucken-Muster ist essenziell für Anwendungen, die auf verschiedenen Maschinen bereitgestellt werden. Das Hardcodieren eines Druckernamens funktioniert für Szenarien mit einer einzelnen Maschine, aber Produktionsanwendungen sollten verfügbare Drucker abfragen und entweder dem Benutzer die Wahl überlassen oder einen programmatisch basierend auf Namenskonventionen auswählen.

Die Druckerauswahl kann auch mit Papiergröße, DPI, Kopienanzahl und Rändern in einem einzigen Konfigurationsobjekt kombiniert werden.

Eingabe

quarterly-report.pdf ist ein A4 vierteljährlicher Finanzbericht mit KPI-Karten und Diagrammen, gedruckt mit PrinterName kombiniert mit Papiergröße, DPI und Kopienanzahl in einem PrintSettings Objekt.

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-combined-settings.cs

using IronPrint;

// Configure full print settings with a named printer
PrintSettings settings = new PrintSettings
{
    PrinterName = "Office Color Printer",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    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 with a named printer
Dim settings As New PrintSettings With {
    .PrinterName = "Office Color Printer",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

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

Wir verwenden die Objektinitialisierer-Syntax für bessere Lesbarkeit. PrinterName leitet den Auftrag an 'Office Color Printer', während die verbleibenden Eigenschaften das Ausgabeformat steuern. Dpi bei 300 erzeugt scharfen Text und Grafiken. PaperMargins akzeptiert Millimeterwerte durch den Margins Konstruktor. Für die vollständige Liste der verfügbaren Eigenschaften siehe den Leitfaden zu Druckeinstellungen.

Ausgabe

Der Quartalsbericht druckt mit dem benannten Drucker, A4-Hochformat, 300 DPI, 2 Kopien und 15 mm Rändern in einem Auftrag. Der Auftrag erscheint in der Druckerwarteschlange wie oben zu sehen.

Quartalsberichtsausgabe mit PrinterName, A4, 300 DPI, 2 Kopien und 15 mm Rändern.

IronPrint validiert die Konfiguration als Einheit und übermittelt die kombinierten Einstellungen in einem einzigen Auftrag an den Druckertreiber.

Anwendungen, die den Hauptthread während der Druckererkennung oder des Druckens nicht blockieren können, können die asynchronen Entsprechungen beider Vorgänge verwenden.

Ausgabe

Die Rechnung wird asynchron an den zuerst entdeckten Drucker gedruckt. Der Auftrag erscheint in der Druckerwarteschlange wie oben zu sehen.

Rechnungsausgabe asynchron an den ersten verfügbaren Drucker gedruckt.

In der Produktion könnten wir printers[0] durch eine Logik ersetzen, die einer Namenskonvention entspricht, z.B. das Suchen nach Druckern mit 'Label' für Versandetiketten oder 'Color' für gebrandete Dokumente. Die asynchronen Methoden von IronPrint akzeptieren alle das gleiche PrintSettings Objekt, sodass PrinterName Verhalten zwischen synchronen und asynchronen Pfaden identisch ist.

Mit statischer Zuweisung, Laufzeiterkennung, kombinierten Einstellungen und asynchronen Workflows, die alle abgedeckt sind, sind einige verwandte Ressourcen es wert, als Lesezeichen gespeichert zu werden.