Esta página puede contener texto traducido automáticamente.
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
Usa el complemento HtmlToPdf para convertir HTML a PDF. Este complemento utiliza Google Chrome y su motor de renderizado Blink, por lo que es compatible con HTML5, CSS3 y JavaScript. Puedes generar PDF a partir de HTML, SVG, WEBP y otros formatos web con el complemento.
Para obtener más información sobre la API de HTML a PDF que ofrece el complemento, consulte la descripción general de sus funciones. El artículo explica cómo instalar el complemento desde NuGet o manualmente. También incluye código de ejemplo.
Complemento Layout
Usa el complemento Layout para generar archivos PDF a partir de elementos de diseño estructurados. Crea documentos a partir de fragmentos de texto, imágenes, tablas, encabezados, pies de página, contenedores y, opcionalmente, componentes personalizados reutilizables. La fluida API de Layout se encarga de todo.
En lugar de colocar elementos en coordenadas fijas, se describen documentos completos en código mediante una API clara y expresiva que adapta el diseño tanto al contenido como al tamaño de la página. El motor de diseño gestiona automáticamente la paginación, la anidación y las estructuras complejas. Esto facilita la creación de cualquier documento, desde páginas sencillas hasta sofisticados informes PDF.
Para obtener más información sobre cómo generar archivos PDF en .NET con la API de diseño, lea el artículo que explica sus características en profundidad e incluye instrucciones de instalación y código de muestra.
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.