Imprimante PDF .NET (Tutoriel pour développeurs)

Quelles sont les caractéristiques essentielles qui distinguent IronPrint ?

1. Polyvalence : Compatible avec les fichiers PDF, HTML et image, ce logiciel offre une grande flexibilité pour différents types de documents. Le tutoriel d'impression illustre son utilisation sur plusieurs plateformes.

2. Facilité d'intégration : Une API intuitive et une documentation complète réduisent le temps et les efforts de développement. La présentation des fonctionnalités de la bibliothèque met en évidence ses capacités d'intégration transparentes.

3. Options d'impression avancées : Contrôlez la mise en page, l'orientation, le format du papier et la qualité pour répondre à des exigences spécifiques. Appliquez des paramètres d'impression personnalisés , notamment les marges, la résolution (DPI) et les spécifications du papier, grâce à un code simple.

4. Compatibilité parfaite : S'intègre avec ASP.NET, WPF et Windows Forms pour divers scénarios de développement. Les instructions spécialisées pour le framework d'applications Web ASP.NET incluent des fonctionnalités d'impression asynchrone.

5. Fiabilité et assistance : Bénéficiez de la réputation de qualité d'Iron Software grâce à une assistance robuste et des mises à jour fréquentes. Le journal des modifications vous tient informé des dernières améliorations.

Comment configurer mon projet pour l'impression PDF ?

Pour commencer, créons un nouveau projet .NET dans Visual Studio et installons la bibliothèque IronPrint via le gestionnaire de packages NuGet. Ouvrez Visual Studio et suivez ces étapes :

1. Choisissez " Fichier " > " Nouveau " > " Projet " pour créer un nouveau projet .NET.

   Le menu Fichier de Visual Studio s'ouvre et affiche les options permettant de créer un nouveau projet ; les options " Nouveau " et " Projet " sont mises en évidence.

2. Sélectionnez le modèle de projet approprié ( eg , application console, application Web ASP.NET) et cliquez sur " Suivant ".

   La boîte de dialogue " Créer un projet " de Visual Studio affiche différents modèles de projets .NET, notamment les applications console, les applications web Blazor et les applications ASP.NET Core, avec des options de filtrage pour C#, Windows et tous les types de projets.

3. Saisissez un nom pour votre projet et choisissez un emplacement pour l'enregistrer. Cliquez sur "Next" pour continuer.

   La fenêtre de dialogue " Configurer votre nouveau projet " de Visual Studio affiche les options de configuration d'un projet d'application console, avec des champs pour le nom du projet, son emplacement et les paramètres de la solution.

4. Une fois le projet créé, ouvrez la console du gestionnaire de packages NuGet (accessible via " Outils " > " Gestionnaire de packages NuGet " > " Console du gestionnaire de packages ").

5. Utilisez la commande suivante pour installer le package IronPrint :

   Install-Package IronPrint

6. Vous pouvez également installer le package à l'aide de l'interface utilisateur du gestionnaire de packages NuGet en recherchant " IronPrint " et en cliquant sur " Installer ".

IronPrint étant installé avec succès, nous sommes prêts à passer à l'étape suivante : la mise en œuvre de la fonctionnalité d'impression PDF. N'oubliez pas de configurer correctement vos clés de licence pour une utilisation en production. Pour les applications ASP.NET, il peut être nécessaire de définir la clé de licence dans le fichier Web.config afin d'éviter les erreurs d'installation courantes.

Quel code me faut-il pour imprimer des documents PDF ?

Maintenant que notre projet est configuré, écrivons du code pour implémenter la fonctionnalité d'impression PDF à l'aide d'IronPrint. Nous allons créer une application .NET simple qui imprime un document PDF à l'aide d'IronPrint. Voici un exemple simple de la manière d'y parvenir :

using IronPrint;

class Program
{
    static void Main(string[] args)
    {
        // Create a new PrintSettings object to define printing preferences
        PrintSettings printSettings = new PrintSettings();

        // Set DPI (dots per inch) for clear printing
        printSettings.Dpi = 150;

        // Specify the number of copies to print
        printSettings.NumberOfCopies = 2;

        // Set paper orientation to Portrait
        printSettings.PaperOrientation = PaperOrientation.Portrait;

        // Print the specified PDF file using the default printer
        Printer.Print("output.pdf", printSettings);
    }
}

using IronPrint;

class Program
{
    static void Main(string[] args)
    {
        // Create a new PrintSettings object to define printing preferences
        PrintSettings printSettings = new PrintSettings();

        // Set DPI (dots per inch) for clear printing
        printSettings.Dpi = 150;

        // Specify the number of copies to print
        printSettings.NumberOfCopies = 2;

        // Set paper orientation to Portrait
        printSettings.PaperOrientation = PaperOrientation.Portrait;

        // Print the specified PDF file using the default printer
        Printer.Print("output.pdf", printSettings);
    }
}

Le code C# ci-dessus utilise la bibliothèque IronPrint pour l'impression de fichiers PDF. Cela commence par l'importation de l'espace de noms nécessaire, IronPrint. Dans la méthode Main , elle initialise un objet PrintSettings , configurant des paramètres tels que le DPI, le nombre de copies et l'orientation du papier. Dans ce cas, la résolution (DPI) est fixée à 150, le nombre de copies à 2 et l'orientation du papier à Portrait. Enfin, elle appelle la méthode Print de la classe Printer , en spécifiant le nom du fichier de sortie comme " output.pdf " et en passant l'objet printSettings . Cet extrait de code illustre une configuration de base pour l'impression de PDF à l'aide de la bibliothèque IronPrint en C# et de l'imprimante par défaut.

Pour des scénarios plus avancés, vous pouvez opter pour une impression avec options de dialogue , permettant aux utilisateurs de configurer leurs préférences d'impression via une interface familière. Voici un exemple :

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

class AdvancedPrintingExample
{
    static void Main(string[] args)
    {
        // Get available printers on the system
        List<string> printerNames = Printer.GetPrinterNames();

        Console.WriteLine("Available printers:");
        foreach (string printer in printerNames)
        {
            Console.WriteLine($"- {printer}");
        }

        // Create advanced print settings
        PrintSettings advancedSettings = new PrintSettings()
        {
            // Specify a particular printer
            PrinterName = printerNames[0], // Use first available printer

            // Set paper size to A4
            PaperSize = PaperSize.A4,

            // Configure margins (in hundredths of an inch)
            MarginTop = 50,
            MarginBottom = 50,
            MarginLeft = 100,
            MarginRight = 100,

            // Enable grayscale printing
            Grayscale = true,

            // Set custom DPI for high-quality output
            Dpi = 300
        };

        // Show print dialog for user customization
        Printer.ShowPrintDialog("output.pdf", advancedSettings);
    }
}

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

class AdvancedPrintingExample
{
    static void Main(string[] args)
    {
        // Get available printers on the system
        List<string> printerNames = Printer.GetPrinterNames();

        Console.WriteLine("Available printers:");
        foreach (string printer in printerNames)
        {
            Console.WriteLine($"- {printer}");
        }

        // Create advanced print settings
        PrintSettings advancedSettings = new PrintSettings()
        {
            // Specify a particular printer
            PrinterName = printerNames[0], // Use first available printer

            // Set paper size to A4
            PaperSize = PaperSize.A4,

            // Configure margins (in hundredths of an inch)
            MarginTop = 50,
            MarginBottom = 50,
            MarginLeft = 100,
            MarginRight = 100,

            // Enable grayscale printing
            Grayscale = true,

            // Set custom DPI for high-quality output
            Dpi = 300
        };

        // Show print dialog for user customization
        Printer.ShowPrintDialog("output.pdf", advancedSettings);
    }
}

Cet exemple montre comment obtenir les noms des imprimantes et récupérer leurs informations, permettant ainsi à votre application d' obtenir des informations sur les imprimantes des périphériques locaux sur les plateformes Windows, iOS et Android. Le guide complet des paramètres d'impression couvre toutes les options de configuration disponibles via la classe PrintSettings .

! Boîte de dialogue " Enregistrer et imprimer " de Windows affichant une interface d'enregistrement de fichier avec le dossier " net6.0 " contenant des fichiers PDF, avec le champ Nom de fichier et l'option " Enregistrer au format PDF " sélectionnée