Empezando

Este artículo explica algunos conceptos básicos que le ayudarán a empezar a procesar archivos PDF en sus aplicaciones .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity y HoloLense con la biblioteca Docotic.Pdf.

Instalación de la biblioteca Docotic.Pdf

Instalación desde NuGet

La forma más sencilla de comenzar es instalar el paquete BitMiracle.Docotic.Pdf desde NuGet.

Consulte este artículo de inicio rápido si es nuevo en NuGet Manager.

Instalación manual

Descargue la última versión de la biblioteca Docotic.Pdf desde nuestro sitio. Distribuimos la biblioteca como un paquete ZIP. El paquete contiene la biblioteca Docotic.Pdf, todos los proyectos de código de muestra, complementos de la biblioteca y acuerdos de licencia.

Extraiga el paquete ZIP descargado a la ubicación que elija.

En Visual Studio, abra el cuadro de diálogo Agregar referencia, busque la ubicación donde extrajo el paquete ZIP y seleccione la DLL desde allí.

Ejecutando código de muestra

Los ejemplos de código para Docotic.Pdf se encuentran en la carpeta Samples del paquete ZIP. Abra el archivo de solución SamplesCSharp si desea utilizar código de muestra escrito en lenguaje C#. Para una versión VB.NET, abra el archivo de solución SamplesVB.NET.

Puede clonar o descargar los mismos ejemplos de código desde nuestro repositorio de códigos de muestra en GitHub.

Tómese un tiempo para revisar los ejemplos de código. Debería ayudarle a agregar funciones de procesamiento de PDF a su aplicación.

Usando Docotic.Pdf en su proyecto .NET

Para evitar escribir nombres completos de los tipos proporcionados por la biblioteca, es mejor agregar la siguiente directiva using a su archivo fuente de C#:

using BitMiracle.Docotic.Pdf;

En VB.NET usa esto:

Imports BitMiracle.Docotic.Pdf

En un proyecto de C#, agregue el siguiente método al código fuente de su aplicación:

private static void helloPdf()
{
    // reemplace string.Empty con su clave de licencia
    BitMiracle.Docotic.LicenseManager.AddLicenseData(string.Empty);

    string outputName = "hello.pdf";
    // en la aplicación ASP.NET, utilice la siguiente línea en su lugar:
    // string outputName = Server.MapPath("hello.pdf");

    using (PdfDocument pdf = new PdfDocument())
    {
        // dibuja "Hello world" en la primera página
        PdfPage firstPage = pdf.Pages[0];
        firstPage.Canvas.DrawString(20, 20, "Hello world!");

        pdf.Save(outputName);
    }

    // abre el documento guardado en el visor de PDF predeterminado
    System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
        FileName = outputName,
        UseShellExecute = true,
    });
}

En un proyecto VB.NET, utilice el siguiente código:

Private Shared Sub helloPdf()
    ' reemplace string.Empty con su clave de licencia
    BitMiracle.Docotic.LicenseManager.AddLicenseData(String.Empty)

    Dim outputName As String = "hello.pdf"
    ' en la aplicación ASP.NET, utilice la siguiente línea en su lugar:
    ' Dim outputName As String = Server.MapPath("hello.pdf")

    Using pdf As New PdfDocument()
        ' dibuja "Hello world" en la primera página
        Dim firstPage As PdfPage = pdf.Pages(0)
        firstPage.Canvas.DrawString(20, 20, "Hello world!")

        pdf.Save(outputName)
    End Using

    ' abre el documento guardado en el visor de PDF predeterminado
    System.Diagnostics.Process.Start(
        New ProcessStartInfo() With {
            .FileName = outputName,
            .UseShellExecute = True
        }
    )
End Sub

Llame al método helloPdf desde su código. Esto debería generar el archivo hello.pdf y abrirlo en su visor de PDF predeterminado.

Complementos

Puede ampliar la funcionalidad principal con complementos gratuitos.

Complemento HtmlToPdf

Le permite convertir HTML a PDF (o SVG/WEBP a PDF). Puede instalar el paquete BitMiracle.Docotic.Pdf.HtmlToPdf desde NuGet. O agregue manualmente referencias a las siguientes DLL desde el paquete ZIP:

• BitMiracle.Docotic.Pdf.dll
• HtmlToPdf add-on/BitMiracle.Docotic.Pdf.HtmlToPdf.dll
• HtmlToPdf add-on/Microsoft.Bcl.AsyncInterfaces.dll

Complemento Layout

Utilice el complemento para generar documentos PDF a partir de un diseño definido en el código. Utilice bloques de construcción como páginas, contenedores, imágenes, párrafos de texto y similares para crear archivos PDF de cualquier complejidad.

El complemento de diseño divide automáticamente el contenido en páginas y brinda soporte para encabezados y pies de página, tablas y párrafos. Instale el paquete BitMiracle.Docotic.Pdf.Layout desde NuGet. O agregue manualmente referencias a las siguientes DLL desde el paquete ZIP:

• BitMiracle.Docotic.Pdf.dll
• Layout add-on/BitMiracle.Docotic.Pdf.Layout.dll

Complemento Gdi

Le permite imprimir documentos PDF o dibujar PDF en System.Drawing.Graphics. Puede instalar el paquete BitMiracle.Docotic.Pdf.Gdi desde NuGet. O agregue manualmente referencias a las siguientes DLL desde el paquete ZIP:

• BitMiracle.Docotic.Pdf.dll
• Gdi add-on/BitMiracle.Docotic.Pdf.Gdi.dll

Complemento Logging

Puede usarlo para registrar información sobre la estructura interna de documentos PDF. Instale el paquete BitMiracle.Docotic.Pdf.Logging desde NuGet. O agregue manualmente referencias a las siguientes DLL desde el paquete ZIP:

• BitMiracle.Docotic.Pdf.dll
• Logging add-on/BitMiracle.Docotic.Pdf.Logging.dll
• Logging add-on/Microsoft.Extensions.Logging.Abstractions.dll

Conclusión

Ahora debería poder desarrollar funciones relacionadas con PDF en sus aplicaciones utilizando la biblioteca Docotic.Pdf. Sin embargo, esto es sólo el comienzo. Le animamos a leer acerca de las características de la biblioteca y revisar ejemplos de código. Quizás también quieras consultar el blog de Bit Miracle.