Impresora PDF .NET (Tutorial para desarrolladores)

¿Cuáles son las características esenciales que hacen que IronPrint se destaque?

1. Versatilidad : Admite archivos PDF, HTML e imágenes, lo que proporciona flexibilidad para diferentes tipos de documentos. El tutorial de impresión de documentos muestra su uso en múltiples plataformas.

2. Facilidad de integración : la API intuitiva y la documentación completa reducen el tiempo y el esfuerzo de desarrollo. La descripción general de las características de la biblioteca resalta las capacidades de integración perfecta.

3. Opciones de impresión avanzadas : controle el diseño de la página, la orientación, el tamaño del papel y la calidad para cumplir con requisitos específicos. Aplique configuraciones de impresión personalizadas, incluidos márgenes, DPI y especificaciones de papel, con un código simple.

4. Compatibilidad perfecta : se integra con ASP.NET, WPF y Windows Forms para diversos escenarios de desarrollo. La guía especializada para ASP.NET Web App Framework incluye capacidades de impresión asincrónica.

5. Confiabilidad y soporte : respaldado por la reputación de calidad de Iron Software con soporte sólido y actualizaciones frecuentes. El registro de cambios lo mantiene informado de las últimas mejoras.

¿Cómo configuro mi proyecto para imprimirlo en PDF?

Para comenzar, vamos a crear un nuevo proyecto .NET en Visual Studio e instalar la biblioteca IronPrint a través del Administrador de Paquetes NuGet. Abra Visual Studio y siga estos pasos:

1. Elige "Archivo" > "Nuevo" > "Proyecto" para crear un nuevo proyecto .NET.

   ! El menú Archivo de Visual Studio se abre y muestra opciones para crear un nuevo proyecto, con las opciones "Nuevo" y "Proyecto" resaltadas.

2. Seleccione la plantilla de proyecto adecuada ( eg , aplicación de consola, aplicación web ASP.NET) y haga clic en "Siguiente".

   El cuadro de diálogo "Crear un nuevo proyecto" de Visual Studio muestra varias plantillas de proyectos .NET, incluidas las de aplicaciones de consola, aplicaciones web Blazor y opciones de ASP.NET Core, con opciones de filtrado para C#, Windows y todos los tipos de proyectos.

3. Ingresa un nombre para tu proyecto y elige una ubicación para guardarlo. Haga clic en "Next" para continuar.

   Ventana de diálogo "Configurar su nuevo proyecto" de Visual Studio que muestra las opciones de configuración del proyecto para una aplicación de consola con campos para el nombre del proyecto, la ubicación y la configuración de la solución.

4. Una vez creado el proyecto, abra la consola del administrador de paquetes NuGet (accesible a través de "Herramientas" > "Administrador de paquetes NuGet" > "Consola del administrador de paquetes").

5. Usa el siguiente comando para instalar el paquete IronPrint:

   Install-Package IronPrint

6. Alternativamente, puedes instalar el paquete utilizando la interfaz de usuario del Administrador de Paquetes NuGet buscando "IronPrint" y haciendo clic en "Instalar".

Con IronPrint instalado con éxito, estamos listos para pasar al siguiente paso: implementar la funcionalidad de impresión de PDF. Recuerde configurar sus claves de licencia correctamente para su uso en producción. Para las aplicaciones ASP.NET, es posible que deba configurar la clave de licencia en Web.config para evitar errores de configuración comunes.

¿Qué código necesito para imprimir documentos PDF?

Ahora que nuestro proyecto está configurado, escribamos algo de código para implementar la funcionalidad de impresión PDF usando IronPrint. Crearemos una aplicación .NET sencilla que imprime un documento PDF usando IronPrint. A continuación se muestra un ejemplo básico de cómo lograr esto:

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);
    }
}

El código C# anterior utiliza la biblioteca IronPrint para la impresión de PDF. Comienza importando el espacio de nombres necesario IronPrint. Dentro del método Main, inicializa un objeto PrintSettings, configurando parámetros como DPI, número de copias y orientación del papel. En este caso, el DPI se establece en 150, el número de copias en 2 y la orientación del papel en Retrato. Finalmente, llama al método Print de la clase Printer , especificando el nombre del archivo de salida como " output.pdf " y pasando el objeto printSettings . Este fragmento de código demuestra una configuración básica para la impresión de PDF usando la biblioteca IronPrint en C# y la impresora predeterminada.

Para escenarios más avanzados, es posible que desee imprimir con opciones de diálogo , lo que permite a los usuarios configurar sus preferencias de impresión a través de una interfaz familiar. Aquí hay un ejemplo:

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);
    }
}

Este ejemplo demuestra cómo obtener nombres de impresoras y recuperar información de impresoras, lo que permite que su aplicación obtenga información de impresoras para dispositivos locales en plataformas Windows, iOS y Android. La guía completa de configuración de impresión cubre todas las opciones de configuración disponibles mediante la clase PrintSettings .

Cuadro de diálogo Guardar salida de impresión de Windows que muestra una interfaz para guardar archivos con la carpeta 'net6.0' que contiene archivos PDF, con el campo de nombre de archivo y la opción Guardar como PDF seleccionada.