Wie lege ich den Druckernamen in C# fest?

Eingabe

invoice.pdf ist eine formatierte A4-B2B-Rechnung mit Einzelposten und Summen, die über PrintSettings.PrinterName auf einem bestimmten benannten Drucker ausgedruckt wird.

: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)

Zunächst instanziieren wir PrintSettings, das mit PrinterName = null initialisiert wird, also dem Standarddrucker des Betriebssystems. Anschließend überschreiben wir PrinterName durch den genauen String-Namen des Ziel-Druckers. Wenn wir Printer.Print aufrufen, sendet 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; Bei diesem Vergleich wird zwischen Groß- und Kleinschreibung unterschieden. Eine Nichtübereinstimmung wie "hp laserjet" anstelle von "HP LaserJet" führt zu einem stillen Fehler oder löst eine Fehlermeldung aus. Zweitens: Wenn der Benutzer über ShowPrintDialog einen PRINT-Dialog öffnet, überschreibt die Auswahl im Dialog alles, was im Code unter PrinterName festgelegt wurde, sodass der Benutzer die endgültige Kontrolle hat.

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 alle dem Betriebssystem bekannten Drucker abzurufen, einschließlich lokaler, Netzwerk- und virtueller Drucker wie "Microsoft Print to PDF". Anschließend durchlaufen wir die Liste und wählen einen Drucker anhand des Index, der Namensübereinstimmung oder einer beliebigen benutzerdefinierten Logik aus, 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-Quartalsfinanzbericht mit KPI-Karten und Diagrammen, gedruckt mit PrinterName in Kombination mit Papierformat, DPI und Exemplaranzahl 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 den "Office Color Printer" weiter, während die übrigen Eigenschaften das Ausgabeformat steuern. Dpi bei 300 sorgt für scharfen Text und Grafiken. PaperMargins akzeptiert Millimeterwerte über 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. die Suche nach Druckern mit dem Begriff "Label" für Versandetiketten oder "Color" für Markendokumente. Die asynchronen Methoden von IronPrint akzeptieren alle dasselbe PrintSettings-Objekt, sodass das PrinterName-Verhalten bei 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.