Esta página puede contener texto traducido automáticamente.
Primeros pasos
Este artículo explica algunos conceptos básicos para empezar a procesar archivos PDF en sus aplicaciones .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity y HoloLens con la biblioteca Docotic.Pdf.
Instalando la biblioteca Docotic.Pdf
Instalando desde NuGet
La forma más sencilla de empezar 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 versión más reciente 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 ejemplo, complementos de la biblioteca y acuerdos de licencia.
Extraiga el paquete ZIP descargado en la ubicación que prefiera.
En Visual Studio, abra el cuadro de diálogo Agregar referencia, busque la ubicación donde extrajo el paquete ZIP y seleccione allí el DLL.
Ejecutar código de ejemplo
Los ejemplos de código de Docotic.Pdf están en la carpeta Samples del paquete ZIP. Abra el archivo de solución SamplesCSharp si desea usar ejemplos escritos en C#. Para una versión en VB.NET, abra el archivo de solución SamplesVB.NET.
Puede clonar o descargar los mismos ejemplos de código desde nuestro repositorio de ejemplos de código en GitHub.
Dedique un momento a revisar los ejemplos de código. Le ayudarán a agregar características de procesamiento de PDF a su aplicación.
Usando Docotic.Pdf en su proyecto .NET
Para evitar escribir los 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 use esto:
Imports BitMiracle.Docotic.Pdf
En un proyecto 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 una aplicación ASP.NET use 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 PDF predeterminado
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
FileName = outputName,
UseShellExecute = true,
});
}
En un proyecto VB.NET, use 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 una aplicación ASP.NET use 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 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 PDF predeterminado.
Complementos
Puede ampliar la funcionalidad principal con complementos gratuitos.
Complemento HtmlToPdf
Use el complemento HtmlToPdf para convertir HTML a PDF. El complemento usa Google Chrome y su motor de renderizado Blink, por lo que ofrece un gran soporte para HTML5, CSS3 y JavaScript. Puede generar PDF a partir de HTML, SVG, WEBP y otros formatos web usando el complemento.
Para obtener más información sobre la API de HTML a PDF proporcionada por el complemento, lea la descripción general de sus características. El artículo explica cómo instalar el complemento desde NuGet o manualmente. También incluye código de ejemplo.
Complemento Layout
Use el complemento Layout para generar PDF a partir de elementos de diseño estructurados. Compone documentos con fragmentos de texto, imágenes, tablas, encabezados, pies de página, contenedores y, opcionalmente, componentes personalizados reutilizables, y la Layout API, con una sintaxis fluida, organiza todo por usted.
En lugar de colocar elementos en coordenadas fijas, describe documentos completos en código usando una API limpia y expresiva que adapta el diseño tanto al contenido como al tamaño de la página. El motor de diseño luego se encarga automáticamente de la paginación, el anidamiento y las estructuras complejas. Esto facilita la creación de todo, desde páginas simples hasta sofisticados informes PDF.
Para obtener más información sobre la generación de PDF en .NET con la Layout API, lea el artículo que explica sus características en profundidad e incluye instrucciones de instalación y código de ejemplo.
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 bien, agregue manualmente referencias a los siguientes DLL del 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 los documentos PDF. Instale el paquete BitMiracle.Docotic.Pdf.Logging desde NuGet. O bien, agregue manualmente referencias a los siguientes DLL del 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 características relacionadas con PDF en sus aplicaciones usando la biblioteca Docotic.Pdf. Sin embargo, esto es solo el comienzo. Le recomendamos leer sobre las características de la biblioteca y revisar los ejemplos de código. También puede visitar el blog de Bit Miracle.