¿Cómo especificar el nombre de la impresora en C#?

Entrada

invoice.pdf es una factura B2B de estilo A4 con line items y totales, impresa en una impresora con nombre específico a través de 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)

Primero instanciamos PrintSettings, que se inicializa con PrinterName = null, lo que significa la impresora predeterminada del sistema operativo. Luego sobreescribimos PrinterName con el nombre exacto de la impresora de destino. Cuando llamamos a Printer.Print, IronPrint envía el trabajo directamente a la cola de esa impresora.

Resultado

La factura se envía directamente a la impresora nombrada. El trabajo aparece en la cola de la impresora como se ve en el ejemplo de impresión silenciosa.

Salida de la factura impresa en "Microsoft Print to PDF" usando PrinterName.

Dos detalles a tener en cuenta. Primero, el nombre de la impresora debe coincidir exactamente con lo que informa el sistema operativo; esta comparación distingue entre mayúsculas y minúsculas. Una discrepancia como "hp laserjet" en lugar de "HP LaserJet" fallará silenciosamente o lanzará un error. En segundo lugar, si el usuario abre un cuadro de diálogo de impresión a través de ShowPrintDialog, la selección del cuadro de diálogo anula lo que se configuró en el código, dando al usuario el control final.

Si el nombre de la impresora no se conoce de antemano, podemos consultar todas las impresoras instaladas en tiempo de ejecución en lugar de codificar el valor.

Entrada

report.pdf es un informe de negocios A4 con una sección de resumen y una tabla de datos, impreso en la primera impresora descubierta dinámicamente.

: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

Llamamos a GetPrinterNames para recuperar cada impresora que el sistema operativo conoce, incluyendo impresoras locales, de red y virtuales como "Microsoft Print to PDF". Luego iteramos a través de la lista y seleccionamos una impresora por índice, emparejamiento de nombres, o cualquier lógica personalizada que la aplicación requiera.

Resultado

El informe se envía a la primera impresora disponible. El trabajo aparece en la cola de la impresora como se ve arriba.

Salida del informe impresa en la primera impresora disponible a través de GetPrinterNames.

Este patrón de descubrir y luego imprimir es esencial para aplicaciones desplegadas en diferentes máquinas. Codificar un nombre de impresora funciona para escenarios de una sola máquina, pero las aplicaciones de producción deberían consultar las impresoras disponibles y dejar que el usuario escoja o seleccionarla programáticamente basada en convenciones de nombres.

La selección de impresora también puede emparejarse con el tamaño del papel, DPI, cantidad de copias y márgenes en un único objeto de configuración.

Entrada

quarterly-report.pdf es un informe financiero trimestral A4 con tarjetas KPI y gráficos, impreso con PrinterName combinado con tamaño de papel, DPI y recuento de copias en un objeto PrintSettings.

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

Usamos la sintaxis del inicializador de objetos para mejorar la legibilidad. PrinterName dirige el trabajo a "Impresora de color de oficina" mientras que las propiedades restantes controlan el formato de salida. Dpi a 300 produce texto y gráficos nítidos. PaperMargins acepta valores en milímetros a través del constructor Margins. Para la lista completa de propiedades disponibles, vea la guía de configuración de impresión.

Resultado

El informe trimestral se imprime con la impresora nombrada, en orientación vertical A4, 300 DPI, 2 copias y márgenes de 15 mm combinados en un solo trabajo. El trabajo aparece en la cola de la impresora como se ve arriba.

Salida del informe trimestral con PrinterName, A4, 300 DPI, 2 copias y márgenes de 15 mm.

IronPrint valida la configuración como una unidad y envía los ajustes combinados al controlador de la impresora en un solo trabajo.

Las aplicaciones que no pueden bloquear el hilo principal durante el descubrimiento de la impresora o la impresión pueden usar los equivalentes asincrónicos de ambas operaciones.

Resultado

La factura se imprime asincrónicamente en la primera impresora descubierta. El trabajo aparece en la cola de la impresora como se ve arriba.

Salida de la factura impresa asincrónicamente a la primera impresora disponible.

En producción, podríamos reemplazar printers[0] con la lógica que coincide con una convención de nombres, como buscar impresoras que contengan "Etiqueta" para etiquetas de envío o "Color" para documentos de marca. Los métodos asincrónicos de IronPrint aceptan todos el mismo objeto PrintSettings, por lo que el comportamiento de PrinterName es idéntico entre rutas síncronas y asincrónicas.

Con asignación estática, descubrimiento en tiempo de ejecución, configuraciones combinadas y flujos de trabajo asincrónicos, todos cubiertos, una serie de recursos relacionados merece ser marcada.