Comment configurer les paramètres d'impression en C# ; avec IronPrint

Updated: 4 juin 2026

Configurez les paramètres d'impression en C# en utilisant la classe PrintSettings d'IronPrint pour contrôler la taille du papier, l'orientation, la résolution DPI, les marges et bien plus. Instanciez simplement PrintSettings, définissez vos préférences et transmettez-les à la méthode Print.

Démarrage rapide : Configurer les paramètres d'impression

Install IronPrint via NuGet: Install-Package IronPrint
Ajoutez using IronPrint; au fichier
Créez un objet PrintSettings
Réglez des propriétés telles que PaperSize, Dpi, PaperOrientation, NumberOfCopies et Grayscale
Passez les paramètres à Printer.Print() ou Printer.ShowPrintDialog()

1Install IronPrint with NuGet Package Manager
PM > Install-Package IronPrint
```
Install-Package IronPrint
```

2Copiez et exécutez cet extrait de code.

using IronPrint;

// Print with custom settings
Printer.Print("document.pdf", new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = true
});

using IronPrint;

// Print with custom settings
Printer.Print("document.pdf", new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = true
});

3Déployez pour tester sur votre environnement de production.

Commencez à utiliser IronPrint dans votre projet dès aujourd'hui avec un essai gratuit

Flux de travail minimal (5 étapes)

Installez la bibliothèque d'impression C# IronPrint
Créer un objet PrintSettings
Configurez la taille du papier, l'orientation, les DPI, le nombre de copies, et plus encore
Passez les paramètres à Printer.Print() ou Printer.ShowPrintDialog()
Vérifiez que le document imprimé correspond à vos paramètres configurés

Comment définir les paramètres d'impression?

Pour configurer les paramètres d'impression, instanciez la classe PrintSettings et configurez-la selon vos préférences. Dans les méthodes Print ou ShowPrintDialog, passez l'objet PrintSettings en tant que second paramètre. L'exemple de code ci-dessous illustre cette utilisation. Pour des exemples plus détaillés, consultez la page exemples de codes de paramètres d'impression.

// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);

// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);

' Import the necessary namespace for IronPrint
Imports IronPrint

' Initialize a new instance of the PrintSettings class
Private settings As New PrintSettings()

' Configure various print settings
settings.PaperSize = PaperSize.A4 ' Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape ' Set paper orientation to Landscape
settings.Dpi = 300 ' Set print resolution to 300 DPI
settings.NumberOfCopies = 2 ' Set the number of copies to 2
settings.PrinterName = "MyPrinter" ' Set the name of the printer
settings.PaperMargins = New Margins(10, 10, 10, 10) ' Set margins to 10mm on each side
settings.Grayscale = True ' Print in grayscale

' Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings)

' Import the necessary namespace for IronPrint
Imports IronPrint

' Initialize a new instance of the PrintSettings class
Private settings As New PrintSettings()

' Configure various print settings
settings.PaperSize = PaperSize.A4 ' Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape ' Set paper orientation to Landscape
settings.Dpi = 300 ' Set print resolution to 300 DPI
settings.NumberOfCopies = 2 ' Set the number of copies to 2
settings.PrinterName = "MyPrinter" ' Set the name of the printer
settings.PaperMargins = New Margins(10, 10, 10, 10) ' Set margins to 10mm on each side
settings.Grayscale = True ' Print in grayscale

' Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings)

Pourquoi dois-je configurer les paramètres d'impression ?

Les paramètres d'impression désignent une configuration ou un ensemble de paramètres qui déterminent comment un document ou un contenu doit être imprimé. Ces paramètres comprennent des détails tels que le format du papier, l'orientation (portrait ou paysage), la résolution d'impression (points par pouce - DPI), le nombre de copies, la sélection de l'imprimante, les marges et des options telles que l'impression en niveaux de gris. Personnalisez ces paramètres pour répondre à vos préférences et exigences spécifiques en matière d'impression.

Les fonctions complètes de paramètres d'impression d'IronPrint permettent aux développeurs de contrôler finement chaque aspect du processus d'impression. Qu'il s'agisse de créer des applications de bureau ou des applications web ASP.NET, une configuration adéquate garantit des résultats cohérents dans différents environnements.

Quand utiliser les paramètres d'impression personnalisés ?

Les paramètres d'impression personnalisés sont essentiels lorsqu'un contrôle précis de la sortie imprimée est nécessaire, par exemple pour imprimer des rapports avec des marges spécifiques, générer plusieurs copies de documents ou s'assurer que les documents s'impriment dans le bon sens pour les besoins de l'entreprise.

Voici un exemple pratique pour l'impression de factures avec des exigences spécifiques :

// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);

// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);

Imports IronPrint

' Invoice printing with specific business settings
Dim invoiceSettings As New PrintSettings With {
    .PaperSize = PaperSize.Letter,        ' US Letter size for business documents
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 600,                           ' High quality for professional output
    .NumberOfCopies = 3,                  ' Original + customer copy + file copy
    .PaperMargins = New Margins(15, 15, 15, 25), ' Extra bottom margin for footer
    .Grayscale = False,                   ' Keep company logo in color
    .PrinterName = "Office Color Printer" ' Specific high-quality printer
}

' Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings)

Imports IronPrint

' Invoice printing with specific business settings
Dim invoiceSettings As New PrintSettings With {
    .PaperSize = PaperSize.Letter,        ' US Letter size for business documents
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 600,                           ' High quality for professional output
    .NumberOfCopies = 3,                  ' Original + customer copy + file copy
    .PaperMargins = New Margins(15, 15, 15, 25), ' Extra bottom margin for footer
    .Grayscale = False,                   ' Keep company logo in color
    .PrinterName = "Office Color Printer" ' Specific high-quality printer
}

' Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings)

Qu'arrive-t-il si je ne spécifie pas les paramètres d'impression?

Si les paramètres d'impression ne sont pas spécifiés, IronPrint utilise les paramètres par défaut de l'imprimante par défaut de votre système, qui peuvent ne pas correspondre au format de sortie prévu ou aux exigences de qualité. Pour découvrir les imprimantes disponibles sur votre système, utilisez la méthode GetPrinterNames pour récupérer toutes les imprimantes connectées de manière programmatique.

Quels sont les paramètres d'impression disponibles ?

Découvrez toutes les options de paramètres d'impression disponibles ci-dessous. La référence API complète fournit une documentation détaillée pour chaque propriété et méthode :

Paramètres	Description du projet	Valeur par défaut	Remarques
`DefaultSettings`	Initialise une nouvelle instance de la classe IronPrint.PrintSettings avec les valeurs par défaut	N/A	N/A
`PaperSize`	Définit le format de papier utilisé par l'imprimante	IronPrint.PaperSize.PrinterDefault	N/A
`PaperOrientation`	Spécifie l'orientation du papier (par exemple, Portrait ou Paysage)	IronPrint.PaperOrientation.Portrait	N/A
`Dpi`	Représente la résolution d'impression prévue en points par pouce	300	Le DPI réel utilisé pour l'impression peut être limité par les capacités de l'imprimante
`NumberOfCopies`	Indique le nombre de copies identiques à générer lors de l'impression d'un document	1	Dans certaines plateformes, il peut exister des limitations qui empêchent la reproduction exacte de plusieurs copies. Dans de tels cas, la valeur spécifiée de `IronPrint.PrintSettings.NumberOfCopies` pourrait être ignorée, n'entraînant que l'impression d'une seule copie.
`PrinterName`	Spécifie le nom de l'imprimante à utiliser pour l'impression	null (utilise l'imprimante par défaut du système d'exploitation)	Si vous choisissez l'imprimante dans une boîte de dialogue d'impression, ce paramètre sera ignoré. Pour obtenir les noms d'imprimantes disponibles, vous pouvez utiliser `IronPrint.Printer.GetPrinterNames` ou `IronPrint.Printer.GetPrinterNamesAsync` pour récupérer la liste des noms d'imprimantes.
`PaperMargins`	Définit les marges à utiliser pour l'impression en millimètres	null (utilise les marges par défaut de l'imprimante)	N/A
`Grayscale`	Indique s'il faut imprimer en niveaux de gris	faux (tentatives d'impression en couleur)	N/A
`Flatten`	Aplatir le PDF avant l'impression, ce qui est utile pour afficher les valeurs des champs de formulaire et les images	false	N/A
`Tray`	Bac d'impression utilisé pour le travail d'impression. Cela permet aux utilisateurs de spécifier un bac particulier à partir duquel le papier doit être alimenté dans l'imprimante	null (utilise le plateau par défaut de l'imprimante)	Si vous choisissez le plateau dans un PrintDialog, ce paramètre sera ignoré. Pour obtenir le réservoir disponible, vous pouvez utiliser `IronPrint.Printer.GetPrinterTrays(System.String)` ou `IronPrint.Printer.GetPrinterTraysAsync(System.String)`. Cette propriété de sélection de plateau n'est disponible que sous Windows

Quels sont les paramètres d'impression que je devrais toujours configurer ?

Pour la plupart des applications professionnelles, configurez toujours PaperSize, PaperOrientation et Dpi pour garantir une sortie cohérente sur différentes imprimantes et systèmes. Ces trois paramètres ont le plus d'impact sur l'apparence et la lisibilité du document.

Lorsque vous travaillez avec une impression basée sur un dialogue, combinez les paramètres personnalisés avec l'interaction de l'utilisateur à l'aide de la méthode ShowPrintDialog :

// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);

// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);

Imports System

' Pre-configure settings but allow user to modify
Dim presetSettings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings)

Imports System

' Pre-configure settings but allow user to modify
Dim presetSettings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings)

Comment gérer les paramètres spécifiques à la plateforme ?

Certains paramètres, comme la sélection de la barre d'état, ne sont disponibles que sous Windows. Vérifiez toujours la compatibilité des plateformes lorsque vous utilisez des fonctionnalités spécifiques à une plateforme, et prévoyez un comportement de repli pour les applications multiplateformes. Pour résoudre les problèmes spécifiques à une plateforme, consultez le guide d'assistance technique.

Quelles sont les combinaisons de paramètres d'impression les plus courantes ?

Les combinaisons courantes sont A4/Portrait/300 DPI pour les documents standard, A3/Paysage/600 DPI pour les rapports détaillés, et Letter/Portrait/300 DPI/échelle de gris pour l'impression de brouillons afin d'économiser de l'encre.

Voici un exemple illustrant différents scénarios :

// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};

// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};

Imports System

' Standard office document
Dim standardDocument As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Detailed engineering drawing
Dim technicalDrawing As New PrintSettings With {
    .PaperSize = PaperSize.A3,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 600,
    .Grayscale = False
}

' Draft mode for review
Dim draftMode As New PrintSettings With {
    .PaperSize = PaperSize.Letter,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 150,
    .Grayscale = True,
    .NumberOfCopies = 5
}

' High-volume batch printing
Dim batchPrint As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 100,
    .Tray = "Tray 2" ' Large capacity tray on Windows
}

Imports System

' Standard office document
Dim standardDocument As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Detailed engineering drawing
Dim technicalDrawing As New PrintSettings With {
    .PaperSize = PaperSize.A3,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 600,
    .Grayscale = False
}

' Draft mode for review
Dim draftMode As New PrintSettings With {
    .PaperSize = PaperSize.Letter,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 150,
    .Grayscale = True,
    .NumberOfCopies = 5
}

' High-volume batch printing
Dim batchPrint As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 100,
    .Tray = "Tray 2" ' Large capacity tray on Windows
}

Pour des exemples plus complets et des scénarios d'impression avancés, consultez le tutoriel sur les documents d'impression qui couvre l'ensemble du processus d'impression du début à la fin.

Lors de la mise en œuvre des paramètres d'impression dans les environnements de production, en particulier dans les applications web utilisant Web.config, consultez le guide sur la définition des clés de licence dans Web.config pour garantir une configuration correcte.

Questions Fréquemment Posées

Comment configurer les paramètres d'impression en C# ?

Pour configurer les paramètres d'impression en C#, instanciez la classe PrintSettings d'IronPrint et définissez des propriétés telles que PaperSize, PaperOrientation, Dpi, NumberOfCopies et Grayscale. Passez ensuite cet objet PrintSettings comme deuxième paramètre des méthodes Print ou ShowPrintDialog.

Quels paramètres d'impression puis-je personnaliser ?

La classe PrintSettings d'IronPrint permet de personnaliser le format du papier (A4, Letter, etc.), l'orientation (Portrait/Paysage), la résolution DPI, le nombre de copies, la sélection de l'imprimante, les marges du papier et les options d'impression en niveaux de gris.

Comment définir la taille et l'orientation du papier ?

Définissez le format du papier à l'aide de la propriété PaperSize (par exemple, PaperSize.A4) et l'orientation à l'aide de la propriété PaperOrientation (par exemple, PaperOrientation.Landscape) dans l'objet PrintSettings d'IronPrint avant d'appeler la méthode Print.

Puis-je imprimer plusieurs exemplaires d'un document ?

Oui, vous pouvez imprimer plusieurs copies en définissant la propriété NumberOfCopies dans la classe PrintSettings. Par exemple, settings.NumberOfCopies = 2 imprimera deux copies de votre document à l'aide d'IronPrint.

Comment définir des marges personnalisées pour l'impression ?

Définissez des marges personnalisées à l'aide de la propriété PaperMargins dans PrintSettings avec la classe Margins. Par exemple : settings.PaperMargins = new Margins(10, 10, 10, 10) définit des marges de 10 mm sur tous les côtés lors de l'impression avec IronPrint.

Puis-je imprimer en niveaux de gris plutôt qu'en couleur ?

Oui, activez l'impression en niveaux de gris en définissant la propriété Grayscale sur true dans l'objet PrintSettings. Cela convertira les documents en couleur en niveaux de gris lors de l'impression par IronPrint.

How can I handle platform-specific print settings with IronPrint?

Check platform compatibility when using settings like Tray selection, which is only available on Windows. Provide fallback options for cross-platform applications.

Why is it important to configure print settings?

Configuring print settings is crucial to ensure documents print as intended with specific parameters like paper size, margins, and quality, maintaining consistency across different environments.

Can I allow users to modify print settings during the print process?

Yes, you can use the `ShowPrintDialog` method to pre-configure settings and allow users to modify them before printing.

What options are available for printing multiple copies of a document?

You can print multiple copies by setting the `NumberOfCopies` property in the `PrintSettings` class. Note that some platforms may have limitations on reproducing multiple copies.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

...