Esta página puede contener texto traducido automáticamente.

Empezando

Este artículo explica algunos de los conceptos básicos que le ayudarán a empezar a procesar archivos PDF en sus aplicaciones WinForms, consola o ASP.NET con la biblioteca Docotic.Pdf.

Empezando con 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

  1. Descargue la última versión de la biblioteca Docotic.Pdf desde nuestro sitio. La biblioteca se distribuye como un paquete ZIP.
    El paquete ZIP contiene dos versiones de la biblioteca:
    • versión para .NET 4.0 y frameworks posteriores
    • versión para .NET Standard 2.0 y marcos posteriores.

    El paquete ZIP también contiene todos los proyectos de muestra y el archivo con el acuerdo de licencia.

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

Ejecución de muestras

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

El mismo código de muestra se puede clonar o descargar desde nuestro repositorio de muestras en GitHub.

Tómese un tiempo para revisar las muestras. Debería ayudarle a agregar funciones de procesamiento de PDF a su aplicación.

Usando Docotic.Pdf en su aplicación WinForms, consola o ASP.NET

  1. Abra el IDE de Visual Studio. Cree un nuevo proyecto o abra uno existente.

  2. Abra el cuadro de diálogo Agregar referencia y agregue una referencia a BitMiracle.Docotic.Pdf.dll.

    • La lista de Extensiones contendrá el ensamblado BitMiracle.Docotic.Pdf si agregó la biblioteca a GAC
    • Alternativamente, puede buscar la ubicación donde extrajo el paquete ZIP y seleccionar la DLL desde allí.

Agregar Docotic.Pdf usando el cuadro de diálogo Agregar referencia

Tenga en cuenta que puede agregar una referencia de NuGet a BitMiracle.Docotic.Pdf en lugar de hacer referencia a su DLL manualmente.

Para acceder a métodos y propiedades que brindan interoperabilidad con tipos del espacio de nombres System.Drawing y GDI+, deberá agregar una referencia a la extensión DLL BitMiracle.Docotic.Pdf.Gdi. Puede encontrar la DLL en el paquete ZIP o instalar el paquete BitMiracle.Docotic.Pdf.Gdi desde NuGet.

Para convertir HTML a PDF (o SVG a PDF), deberá agregar una referencia a la DLL de extensión BitMiracle.Docotic.Pdf.HtmlToPdf. La DLL también está en el paquete ZIP, pero recomendamos instalar el paquete BitMiracle.Docotic.Pdf.HtmlToPdf desde NuGet en lugar de agregar la DLL manualmente.

Para crear documentos PDF utilizando el motor de diseño, agregue la referencia a la DLL de extensión BitMiracle.Docotic.Pdf.Layout. El motor divide automáticamente el contenido en páginas y brinda soporte para encabezados y pies de página, tablas y párrafos. Puede encontrar la DLL en el paquete ZIP, pero le recomendamos instalar el paquete BitMiracle.Docotic.Pdf.Layout desde NuGet en lugar de agregar la DLL manualmente.

  1. Para evitar escribir referencias completas al dll, es mejor agregar la siguiente declaración de uso a las ya existentes en su archivo fuente en C#
    using BitMiracle.Docotic.Pdf;
    

    En VB.NET usa esto:

    Imports BitMiracle.Docotic.Pdf
    
  2. 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,
    });
}

Para un proyecto VB.NET use esto

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
  1. 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.

hello.pdf en un visor de PDF predeterminado

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 recomendamos que lea la documentación que acompaña a la biblioteca y revise las muestras. Quizás también quieras consultar el blog de Bit Miracle.