Druckernamen angeben und PDF drucken an spezifischen Drucker in C

Wie gebe ich einen Druckernamen in C# an?

Wir geben den Zieldrucker an, indem wir seinen Namen der PrinterName-Eigenschaft auf einem PrintSettings-Objekt zuweisen. Anschließend übergeben wir dieses Objekt an Printer.Print.

: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";

// Send the document 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"

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

Wir instanziieren zunächst PrintSettings, das mit PrinterName = null initialisiert wird — das bedeutet der OS-Standarddrucker. Wir überschreiben dann PrinterName mit dem exakten Zeichenkettennamen des Zieldruckers. Wenn wir Printer.Print aufrufen, sendet IronPrint den Auftrag direkt an die Warteschlange dieses Druckers.

Zwei wichtige Details, die Sie beachten sollten. Erstens muss der Druckername genau dem entsprechen, was das Betriebssystem meldet — dieser Vergleich ist buchstabengenau (case-sensitive). Eine Abweichung wie "hp laserjet" statt "HP LaserJet" führt zu einem stillschweigenden Fehler oder einer Fehlerausgabe. Zweitens, wenn der Benutzer einen Druckdialog über ShowPrintDialog öffnet, überschreibt die Dialogauswahl, was auch immer in Code auf PrinterName gesetzt wurde. Dies ist beabsichtigt — der Dialog gibt den Benutzern die endgültige Kontrolle.

Wie ermittle ich verfügbare Drucker?

Anstatt Druckernamen hartzukodieren, können wir das System zur Laufzeit mit Printer.GetPrinterNames() abfragen. Diese Methode gibt eine List<string> zurück, die jeden auf dem Rechner installierten Drucker enthält.

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

using IronPrint;

// Discover all installed printers
List<string> printers = Printer.GetPrinterNames();

foreach (string name in printers)
{
    Console.WriteLine(name);
}

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

Imports IronPrint

' Discover all installed printers
Dim printers As List(Of String) = Printer.GetPrinterNames()

For Each name As String In printers
    Console.WriteLine(name)
Next

' Use 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 abzurufen, den das Betriebssystem kennt — einschließlich lokaler, Netzwerk- und virtueller Drucker wie 'Microsoft Print to PDF'. Wir durchlaufen dann die Liste und wählen einen Drucker basierend auf Index, Namensübereinstimmung oder jeder benutzerdefinierten Logik, die die Anwendung erfordert.

Dieses Muster Ermitteln-dann-Drucken ist für Anwendungen, die auf verschiedenen Maschinen bereitgestellt werden, essenziell. Das Hartcodieren eines Druckernamens funktioniert bei Einmaschinen-Szenarien, aber Produktionsanwendungen sollten verfügbare Drucker abfragen und entweder den Benutzer wählen lassen oder programmatisch basierend auf Namenskonventionen auswählen. Für ein spezielles Codebeispiel sehen Sie sich das Beispiel zum Abrufen von Druckernamen an.

Wie kombiniere ich den Druckernamen mit anderen Einstellungen?

Die PrintSettings-Klasse stellt PrinterName zusammen mit Eigenschaften für Papiergröße, Ausrichtung, DPI, Ränder, Kopienanzahl und Abflachung zur Verfügung. Wir konfigurieren alles in einem einzigen Objekt.

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

using IronPrint;

// Build a fully configured print job targeting a specific 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 a branded report to the color printer
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Build a fully configured print job targeting a specific 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 a branded report to the color printer
Printer.Print("quarterly-report.pdf", settings)

Wir verwenden die Syntax für Objektersteller zur besseren Lesbarkeit. PrinterName leitet den Auftrag zum 'Office Color Printer', während die restlichen Eigenschaften das Ausgabeformat steuern. Dpi bei 300 erzeugt scharfen Text und Grafiken. PaperMargins akzeptiert vier Millimeterwerte durch den Margins-Konstruktor — oben, rechts, unten, links.

IronPrint validiert die Konfiguration als Einheit und übergibt die kombinierten Einstellungen in einem einzigen Auftrag an den Druckertreiber. Für zusätzliche Optionen wie Fachauswahl und Graustufenmodus, sehen Sie sich die vollständige Druckeinstellungen-Anleitung an.

Wie wähle ich einen Drucker aus und drucke asynchron?

Für Anwendungen, bei denen das Blockieren des Hauptthreads keine Option ist — wie WPF- oder WinForms-Apps — verwenden wir Printer.GetPrinterNamesAsync() und Printer.PrintAsync(). Beide geben eine Task zurück und halten die Benutzeroberfläche reaktionsfähig.

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

using IronPrint;
using System.Threading.Tasks;

public class PrintService
{
    public async Task PrintToFirstAvailableAsync(string filePath)
    {
        // Discover printers without blocking the UI
        List<string> printers = await Printer.GetPrinterNamesAsync();

        if (printers.Count == 0)
        {
            Console.WriteLine("No printers found.");
            return;
        }

        // Configure and print to the first available printer
        PrintSettings settings = new PrintSettings
        {
            PrinterName = printers[0],
            Dpi = 300
        };

        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class PrintService
    Public Async Function PrintToFirstAvailableAsync(filePath As String) As Task
        ' Discover printers without blocking the UI
        Dim printers As List(Of String) = Await Printer.GetPrinterNamesAsync()

        If printers.Count = 0 Then
            Console.WriteLine("No printers found.")
            Return
        End If

        ' Configure and print to the first available printer
        Dim settings As New PrintSettings With {
            .PrinterName = printers(0),
            .Dpi = 300
        }

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

Dieses klassenbasierte Beispiel umschließt die Logik zum Ermitteln und Drucken in einem wiederverwendbaren Service. Wir rufen GetPrinterNamesAsync() auf, um die Druckerliste abzurufen, ohne die Benutzeroberfläche einzufrieren, und weisen dann den ersten verfügbaren Drucker PrinterName zu. Der await Printer.PrintAsync-Aufruf sendet den Auftrag asynchron.

In der Produktion könnten wir printers[0] durch eine Logik ersetzen, die einer Namenskonvention entspricht, wie zum Beispiel die Suche nach Druckern, die 'Label' für Versandetiketten oder 'Color' für Marken-Dokumente enthalten. Die asynchronen Methoden von IronPrint akzeptieren alle das gleiche PrintSettings-Objekt, sodass PrinterName-Verhalten bei synchronen und asynchronen Abläufen identisch ist.

Was sind meine nächsten Schritte?

Wir haben behandelt, wie man mithilfe der PrintSettings.PrinterName-Eigenschaft von IronPrint einen Druckernamen in C# angibt, von der statischen Zuweisung bis zur dynamischen Laufzeit-Ermittlung mit Printer.GetPrinterNames(). Die wichtigsten Punkte: Druckernamen müssen genau übereinstimmen (buchstabengenau), null standardmäßig auf den OS-Standarddrucker gesetzt und Druckdialoge überschreiben die programmiert ausgewählte Auswahl.

Um IronPrints Fähigkeiten weiter zu erkunden:

• Siehe das Beispiel zum Abrufen von Druckernamen für ein eigenständiges Ermittlungssnippet
• Erkunden Sie den vollständigen Konfigurationsleitfaden für Druckeinstellungen für alle verfügbaren Eigenschaften
• Überprüfen Sie die API-Referenz der Printer-Klasse für Methoden wie PrintToPrinter, ShowPrintDialog und Fachverwaltung
• Durchsuchen Sie die vollständige API-Referenz für PrintSettings, PaperSize und Margins

Starten Sie eine kostenlose 30-Tage-Testversion, um die Druckerauswahl in Ihren eigenen Projekten zu testen, oder sehen Sie sich Lizenzierungsoptionen für den Produktionseinsatz an.