1. IronPrint
  2. Guides pratiques
  3. paramètres d'impression
Comment configurer les paramètres d'impression dans PDF en utilisant C# | IronPrint

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

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Configurez les paramètres d'impression en C# à l'aide de la classe PrintSettings d'IronPrint pour contrôler la taille du papier, l'orientation, le DPI, les marges et bien plus encore. Il suffit d'instancier PrintSettings, de définir vos préférences et de le transmettre à la méthode Print.

<TODO : Ajouter une image ici -->

Démarrage rapide : Configurer et imprimer à l'aide des paramètres IronPrint

Commencez par créer un objet PrintSettings, en définissant des propriétés telles que le format du papier, l'orientation, le DPI, les copies et les niveaux de gris. Appelez ensuite Printer.Print(...) pour appliquer instantanément ces paramètres ; aucune configuration complexe n'est requise.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPrint avec le gestionnaire de packages NuGet

    PM > Install-Package IronPrint

  2. Copiez et exécutez cet extrait de code.

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

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

    Commencez à utiliser IronPrint dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez une bibliothèque C# pour configurer les paramètres d'impression
  2. Instanciez la classe PrintSettings
  3. Configurez l'objet PrintSettings selon vos préférences
  4. Transmettez-le à la méthode Print ou ShowPrintDialog
  5. Vérifiez le document PDF imprimé et voyez que les paramètres d'impression ont été appliqués

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

<TODO : Ajouter une image ici -->

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, transmettez l'objet PrintSettings en tant que deuxième 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);
$vbLabelText   $csharpLabel

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);
$vbLabelText   $csharpLabel

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 ?

<TODO : Ajouter une image ici -->

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
Paramètres par défaut Initialise une nouvelle instance de la classe IronPrint.PrintSettings avec les valeurs par défaut N/A N/A
Taille du papier Définit le format de papier utilisé par l'imprimante IronPrint.PaperSize.PrinterDefault N/A
Orientation du document 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
Nombre d'exemplaires 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, ce qui entraînerait l'impression d'une seule copie
Nom de l'imprimante 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
Aplatir Aplatir le PDF avant l'impression, ce qui est utile pour afficher les valeurs des champs de formulaire et les images faux 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 bac 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 commerciales, configurez toujours PaperSize, PaperOrientation et Dpi pour garantir une sortie cohérente sur différentes imprimantes et différents 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);
$vbLabelText   $csharpLabel

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
};
$vbLabelText   $csharpLabel

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.

Curtis Chau
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 ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 36,035 | Version : 2025.12 vient de sortir