Comment Récupérer les Noms des Imprimantes en C# pour Imprimer un Document

Comment puis-je lister tous les noms d'imprimantes installées ?

:path=/static-assets/print/content-code-examples/how-to/retrieve-printer-names/retrieve-printer-names-list-all-printers.cs

using IronPrint;
using System;
using System.Collections.Generic;

// Get every printer registered on this Windows machine
List<string> printerNames = Printer.GetPrinterNames();

Console.WriteLine($"Found {printerNames.Count} printer(s):\n");

foreach (string name in printerNames)
{
    Console.WriteLine($"  • {name}");
}

Imports IronPrint
Imports System
Imports System.Collections.Generic

' Get every printer registered on this Windows machine
Dim printerNames As List(Of String) = Printer.GetPrinterNames()

Console.WriteLine($"Found {printerNames.Count} printer(s):" & vbCrLf)

For Each name As String In printerNames
    Console.WriteLine($"  • {name}")
Next

3 imprimante(s) trouvées :

  • Microsoft Print to PDF
  • HP LaserJet Pro MFP M428
  • OneNote (Bureau)

Comment puis-je récupérer les noms des imprimantes de manière asynchrone ?

Pour les applications où le blocage du thread de l'interface utilisateur n'est pas acceptable — WPF, MAUI ou applications web ASP.NET — IronPrint fournit Printer.GetPrinterNamesAsync(). La méthode renvoie un Task<List<string>> et fonctionne identiquement à son équivalent synchrone :

:path=/static-assets/print/content-code-examples/how-to/retrieve-printer-names/retrieve-printer-names-async-printer-names.cs

using IronPrint;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

// Await the async call to avoid blocking the UI thread
List<string> printerNames = await Printer.GetPrinterNamesAsync();

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

Imports IronPrint
Imports System
Imports System.Collections.Generic
Imports System.Threading.Tasks

' Await the async call to avoid blocking the UI thread
Dim printerNames As List(Of String) = Await Printer.GetPrinterNamesAsync()

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

Nous await l'appel comme n'importe quelle autre API asynchrone. Le résultat est le même List<string> retourné par GetPrinterNames(), donc aucun parsing ou conversion supplémentaire n'est nécessaire. Ce modèle asynchrone s'intègre naturellement avec les actions de contrôleur async Task et les gestionnaires d'événements async void.

Comment puis-je imprimer sur une imprimante spécifique par nom ?

Une fois que nous avons le nom de l'imprimante, nous l'attribuons à PrintSettings.PrinterName et passons l'objet paramètres à Printer.Print(). Cela envoie le document directement à l'imprimante choisie sans afficher de dialogue :

:path=/static-assets/print/content-code-examples/how-to/retrieve-printer-names/retrieve-printer-names-print-to-specific-printer.cs

using IronPrint;
using System.Collections.Generic;

// Step 1 — Retrieve available printers
List<string> printers = Printer.GetPrinterNames();

// Step 2 — Select a printer (first match containing "LaserJet" as an example)
string targetPrinter = printers.Find(p => p.Contains("LaserJet"))
                       ?? printers[0]; // fallback to first available

// Step 3 — Configure print settings
PrintSettings settings = new PrintSettings
{
    PrinterName = targetPrinter,
    PaperSize = PaperSize.A4,
    NumberOfCopies = 1
};

// Step 4 — Print the document
Printer.Print("invoice.pdf", settings);

Imports IronPrint
Imports System.Collections.Generic

' Step 1 — Retrieve available printers
Dim printers As List(Of String) = Printer.GetPrinterNames()

' Step 2 — Select a printer (first match containing "LaserJet" as an example)
Dim targetPrinter As String = printers.Find(Function(p) p.Contains("LaserJet")) _
                       OrElse printers(0) ' fallback to first available

' Step 3 — Configure print settings
Dim settings As New PrintSettings With {
    .PrinterName = targetPrinter,
    .PaperSize = PaperSize.A4,
    .NumberOfCopies = 1
}

' Step 4 — Print the document
Printer.Print("invoice.pdf", settings)

PrintSettings prend en charge des propriétés supplémentaires telles que Dpi, PaperOrientation, Grayscale, et PaperMargins. Voir la liste complète dans la référence API PrintSettings et le guide de configuration des paramètres d'impression.

Nous récupérons également les bacs à papier disponibles pour une imprimante donnée en utilisant Printer.GetPrinterTrays(printerName), ce qui est utile lorsqu'un travail d'impression doit tirer du papier d'un bac spécifique.

Quelles Sont Mes Prochaines Étapes ?

Nous avons couvert quatre opérations : l'installation d'IronPrint, la liste de tous les noms d'imprimantes avec GetPrinterNames(), l'exécution de la même requête de manière asynchrone avec GetPrinterNamesAsync(), et le routage d'un document vers une imprimante spécifique via PrintSettings.PrinterName.

Pour des lectures supplémentaires et des exemples plus approfondis, explorez ces ressources :

• Tutoriels IronPrint — Imprimer un document pour des présentations d'impression de bout en bout.
• Guide de configuration des paramètres d'impression pour configurer la résolution, les marges, l'orientation, et plus.
• Référence API de la classe Printer pour la liste complète des méthodes statiques.

Obtenez une licence d'essai gratuite pour tester chaque fonctionnalité dans un environnement en direct, ou voir les options de licences lorsque vous êtes prêt à déployer.