USO DE IRONPDF

C# Crear archivo PDF mediante programación

Para los desarrolladores, hay muchos escenarios en los que surge la necesidad de crear archivos PDF mediante programación. Puede que necesite generar informes PDF y otros archivos PDF mediante programación en su software. Sería largo, caro e ineficaz escribir el código y las funciones desde cero. Aquí es donde entra IronPDF. Aunque crear archivos PDF mediante programación en .NET puede ser frustrante, por suerte ahora existe una solución que lo hace mucho más manejable.

Temas tratados en el tutorial

En este tutorial trataremos los siguientes temas:

Pasos para crear archivos PDF mediante programación

  • Paso 1: Crear un proyecto C
  • Paso 2: Instalar la biblioteca IronPdf

    • Método 1: Gestor de paquetes NuGet

    • Método 2: Consola del gestor de paquetes NuGet
  • Método 3: Utilizar el archivo DLL
  • Paso 3: Agrega el espacio de nombres IronPdf
  • Paso 4: Crear un documento PDF mediante programación

    • 4.1: Crear un documento PDF mediante programación utilizando cadenas HTML

    • 4.2: Crear un documento PDF mediante programación utilizando archivos HTML

    • 4.3: Crear un documento PDF mediante programación utilizando URL
  • 4.4: Crear un documento PDF mediante programación con formato
  • Resumen

IronPDF

IronPDF es una biblioteca PDF de C# para desarrolladores .NET que proporciona un conjunto de clases que se pueden usar para crear archivos PDF de manera programática. Estas clases se encuentran en el ensamblado IronPdf y están diseñadas para ser fáciles de usar con cualquier lenguaje .NET, incluidos C#, VB.NET, F#, etc. La biblioteca ofrece muchas funciones para crear documentos PDF, manipular PDFs existentes y leer PDFs.

La versión actual de la biblioteca IronPDF admite las siguientes funciones:

Pasos para crear archivos PDF mediante programación

Este artículo utilizará la plantilla Aplicación de consola para esta demostración. Puede utilizar cualquiera según sus necesidades y elección. También puede utilizar su proyecto existente en el que desea añadir una herramienta de generación de archivos PDF.

Paso 1: Crear un proyecto C&num

Este tutorial utilizará Visual Studio y el lenguaje de programación C# para construir nuestro proyecto. Debe tener conocimientos básicos de HTML y lenguaje C#. También se recomienda que se familiarice con Visual Studio.

Veremos los múltiples métodos para crear archivos PDF mediante programación utilizando la biblioteca IronPDF C#. Empecemos creando un proyecto C#.

  • Abre Visual Studio.
  • Cree un nuevo proyecto C# o abra un proyecto existente.
  • Dale un nombre al proyecto.
  • Seleccione .Net Core >= 3.1 porque 3.1 es compatible y funciona en todos los dispositivos. Recomienda la versión más reciente de .Net Core.

    Pasemos ahora al paso 2.

Paso 2: Instalar la biblioteca IronPDF

Antes de continuar, debemos instalar la biblioteca IronPdf en nuestro proyecto. Podemos hacerlo de varias maneras.

Método 1: Gestor de paquetes NuGet

Podemos instalar la biblioteca de C# IronPdf desde el Administrador de Paquetes NuGet. Abre el Administrador de Paquetes NuGet haciendo clic en Herramientas > Administrador de Paquetes NuGet > Administrar solución de paquetes NuGet. Esto abrirá el Explorador de soluciones del Gestor de paquetes NuGet.

C# Crear archivo PDF programáticamente, Figura 1: Abrir el Administrador de paquetes NuGet

Abrir el Administrador de Paquetes NuGet

Haz clic en Examinar y escribe IronPdf en la barra de búsqueda. Aparecerá el siguiente resultado. Seleccione IronPdf y haga clic en el botón Instalar; la biblioteca comenzará a instalarse.

C# Crear archivo PDF programáticamente, Figura 2: Buscar e instalar el paquete IronPdf

Buscar e instalar el paquete IronPdf

Método 2: Consola del gestor de paquetes NuGet

Podemos utilizar la consola del gestor de paquetes NuGet para instalar nuestra biblioteca con facilidad. Su instalación no requiere ningún privilegio administrativo. Usarás un comando de NuGet para instalar la biblioteca IronPdf en tu proyecto.

Install-Package IronPdf

C# Crear archivo PDF programáticamente, Figura 3: Instalar paquete IronPdf mediante la línea de comandos

Instalar el paquete de IronPdf a través de la línea de comandos

Método 3: Utilizar un archivo DLL

La tercera forma de utilizar IronPDF en su proyecto es añadir un archivo DLL de la biblioteca IronPDF. Puedes descargar el archivo DLL.

Paso 3: Agrega el espacio de nombres IronPdf

Ahora agrega el espacio de nombres IronPdf a tu programa. Tienes que añadir una línea de código determinada encima del código.

using IronPdf

Esto le permitirá acceder a las funciones de IronPDF. Debe añadir esta línea de código a todos los archivos en los que desee utilizar las funciones de IronPDF.

Paso 4: Crear documentos PDF mediante programación

Veremos varios métodos para crear PDF, como los que ofrece IronPDF. Veremos lo fácil que es utilizar funciones sencillas para crear archivos PDF. Empecemos con la creación de PDF utilizando cadenas HTML.

4.1. Crear PDFs programáticamente usando cadenas HTML

En la biblioteca IronPDF, HTML se utiliza con fines de estilización. Debe tener conocimientos básicos de lenguaje HTML para generar documentos PDF utilizando la biblioteca IronPDF.

La biblioteca IronPDF facilita enormemente el procesamiento de cadenas HTML y su conversión a formato PDF. Veamos cómo hacerlo mediante código.

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim htmlString As String = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>"

Dim renderer = New ChromePdfRenderer()
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")
$vbLabelText   $csharpLabel

Este código generará un archivo PDF con el contenido almacenado en la variable htmlString. En este ejemplo de código, se ha utilizado la función RenderHtmlAsPdf. Esta función realiza la conversión de una cadena HTML en un documento PDF.

Debe estar familiarizado con las etiquetas HTML para generar archivos PDF utilizando la biblioteca IronPDF. Utilizamos la función SaveAs para guardar el archivo PDF de salida. Puede ver el archivo PDF de salida a continuación.

Salida:

C# Crear archivo PDF programáticamente, Figura 4: salida del archivo PDF

Salida de archivo PDF

4.2. Crear PDF mediante programación utilizando archivos HTML

La biblioteca IronPDF ofrece una fantástica función para crear un archivo PDF a partir de un archivo HTML. IronPDF convierte directamente todo lo que hay en un archivo HTML, incluyendo imágenes, CSS, formularios, etc. a un documento PDF. No requiere ninguna otra biblioteca o función para su posterior procesamiento. IronPDF convierte directamente cualquier archivo HTML en un archivo PDF.

Veamos un ejemplo de código para crear un archivo PDF a partir de un archivo HTML:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf")
$vbLabelText   $csharpLabel

Usamos la función RenderHtmlFileAsPdf para crear PDFs a partir de archivos HTML. Esta función es la más importante utilizada en el código de ejemplo. Puedes proporcionar la ubicación del archivo HTML en el parámetro de la función o colocar el archivo HTML en la carpeta bin del código fuente, de modo que solo necesitarás poner el nombre del archivo con la extensión en el parámetro de la función RenderHtmlFileAsPdf. El archivo PDF de salida se guardará en la carpeta bin cuando ejecute este código. La función GuardarComo le ayudará a guardar los archivos PDF creados.

4.3. Crear PDFs programáticamente usando URLs

A veces necesitamos crear archivos PDF de una URL mediante programación en nuestro programa. Esto puede ser una tarea muy técnica si lo codificamos todo desde cero. IronPDF nos ayuda aquí proporcionando una excelente función para crear PDFs a partir de URLs. Puede utilizar cualquier URL para crear un PDF.

Examinemos cómo hacerlo:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")
$vbLabelText   $csharpLabel

El código anterior creará un PDF del parámetro de URL dado para la función RenderUrlAsPdf. Esta función crea un PDF de la URL. De otro modo, esto sería una tarea muy compleja si se intentara hacer desde cero, por lo que IronPDF proporciona a los desarrolladores un proceso sencillo para convertir cualquier URL en un PDF. La función SaveAs se utiliza para guardar los archivos de salida en la carpeta bin. Para establecer el formato de archivo en PDF, debe especificar una extensión .pdf con un parámetro de nombre de archivo en la función GuardarComo. Puedes ver la carpeta bin en la carpeta de tu proyecto. El resultado se muestra a continuación.

Salida:

C# Crear archivo PDF programáticamente, Figura 5: Crear archivo PDF desde URL

Crear archivo PDF desde URL

4.4. Crear PDF mediante programación con formularios web ASP.NET

ASP.NET es un marco de programación del lado del servidor que amplía la funcionalidad de HTML y permite el desarrollo web en un navegador. Las páginas ASP.NET están escritas en HTML, CSS y JavaScript, y se pueden codificar como archivos ASPX (.aspx). Los formularios web ASP.NET crean sitios web, banca en línea, intranets y sistemas de contabilidad fáciles de usar y ricos en funciones.

Utilizaremos la biblioteca IronPDF para convertir formularios web ASP.NET a PDF. Inicialmente representado como una página web, lo transformaremos en un PDF para verlo y descargarlo en un navegador web. Utilizaremos la clase AspxToPdf de IronPDF para completar la conversión.

Veamos cómo hacerlo:

  1. Cree un proyecto de formulario web ASP.NET en Visual Studio. Se recomienda la última versión de Visual Studio.

  2. Instale la biblioteca IronPDF utilizando el Gestor de paquetes NuGet del archivo DLL según su elección. También puede utilizar la consola de NuGet Package Manager para instalarlo.

  3. Ahora, abra el código de cualquier página web apex que desee convertir en un archivo PDF. Aquí crearemos un PDF de la página Default aspx del proyecto.

    C# Crear archivo PDF programáticamente, Figura 6: Estructura del proyecto de formulario web en Visual Studio

    Estructura del proyecto de formulario web en Visual Studio

  4. Abra el archivo Default.aspx.cs. Agregue el espacio de nombres IronPdf al archivo, que es la línea más importante.

    using IronPdf;

  5. Escriba la siguiente línea de código en la función Page_Load para crear un documento PDF de la página.

    AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

    ¡Y eso es todo! Se ha creado un archivo PDF de la página web Aspx. Cuando ejecute el proyecto, verá un PDF de la página web en el navegador. El resultado es el mismo que cuando creas un PDF pulsando Ctrl+P. Aquí no hizo falta pulsar Ctrl+P para crear un PDF del archivo aspx.

    Esto se ha hecho en el lado del servidor. En este código, utilizamos la clase AspxToPdf de IronPDF. La función RenderThisPageAsPdf crea el PDF de la página web Aspx.

    El código anterior muestra el archivo PDF en el navegador. Podemos descargar el archivo PDF directamente en nuestro sistema añadiendo la siguiente línea de código en la función Page_Load:

    AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

    Este código descargará el archivo PDF de la página web aspx en el sistema. También podemos establecer el nombre del archivo PDF de Aspx. Hay múltiples opciones disponibles para modificaciones y formato, como encabezados, pies de página, opciones de impresión, calidad, etc. Para más detalles, visita este tutorial completo de Aspx a PDF.

    Salida:

    C# Creación de archivo PDF programáticamente, Figura 7: Resultado de renderizar un archivo PDF desde el lado del servidor

    Salida de renderizar un archivo PDF desde el lado del servidor

    Explora la última tecnología de Microsoft para aplicaciones Blazor para crear archivos PDF

4.4. Crear PDFs programáticamente con formato

Cuando se crean documentos PDF, la mayoría de los problemas surgen al formatearlos. No es fácil dar formato a un PDF mediante programación. Pero ahora tenemos una solución: IronPDF. IronPDF nos ayuda con varias opciones de formato que nos permiten personalizar el archivo PDF que estamos creando. Nos proporciona métodos para añadir encabezados, pies de página, márgenes y muchas otras opciones de formato.

El uso de IronPDF nos permite establecer la orientación de la página, el tamaño de la página y los títulos. También admite el cambio de tamaño de fuente, color de fuente, tipo de fuente y otras operaciones relacionadas con la fuente. Puede añadir pies de página y cabeceras con una línea divisoria y texto personalizado. Veamos cómo personalizar archivos PDF con IronPDF.

  • Cree un proyecto de consola en C#. También puede crear un proyecto GUI, en función de sus necesidades. También puede abrir proyectos existentes.
  • Instale la biblioteca IronPDF utilizando NuGet Package Manager o el archivo DLL.
  • Añada el espacio de nombres IronPDF en la parte superior del archivo de código.

    Ya hemos terminado de configurar la aplicación. A continuación, añada el siguiente código al archivo PDF:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;

//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");
using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;

//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");
Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer As ChromePdfRenderer = New IronPdf.ChromePdfRenderer()

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40)
Renderer.RenderingOptions.PrintHtmlBackgrounds = True
Renderer.RenderingOptions.Title = "PDF Generated"
Renderer.RenderingOptions.Zoom = 100

'Margin Setting
Renderer.RenderingOptions.MarginTop = 40
Renderer.RenderingOptions.MarginLeft = 20
Renderer.RenderingOptions.MarginRight = 20
Renderer.RenderingOptions.MarginBottom = 40

Renderer.RenderingOptions.FirstPageNumber = 1

'Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = True
Renderer.RenderingOptions.TextHeader.CenterText = "Header!"
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica

'Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = True
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial
Renderer.RenderingOptions.TextFooter.FontSize = 10
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}"
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"

Dim htmlStr As String = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>"
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf")
$vbLabelText   $csharpLabel

Este fragmento de código formatea los archivos PDF. RenderingOptions es la herramienta principal para establecer diferentes propiedades al crear documentos PDF.

  • Renderer.RenderingOptions.TextHeader
  • Esta línea de código se utiliza para configurar la cabecera del archivo PDF. Puede acceder a más propiedades de la cabecera con esta línea de código.
  • Renderer.RenderingOptions.TextFooter
  • Esta línea de código configura las propiedades del pie de página, como el texto, el lado derecho e izquierdo del pie de página, el tamaño de la fuente y muchas otras.
  • Renderer.RenderingOptions.PaperOrientation
  • Esta línea de código permite al usuario establecer la orientación de la página del archivo PDF. Puede designarse como horizontal o vertical.
  • Renderer.RenderingOptions.Title

    • Podemos utilizar esta línea para establecer el título del archivo PDF.

    Para las últimas líneas, utilizamos la función RenderHtmlAsPdf para crear un PDF a partir de una cadena HTML, pero podemos usar un archivo HTML para convertirlo sin problemas en PDF mientras preservamos el formato actual. Esta es una característica muy útil de IronPDF que le da total libertad para personalizar todo lo relacionado con los documentos PDF.

    Salida:

    C# Crear archivo PDF programáticamente, Figura 8: salida PDF con soporte de formato

    Salida de PDF con soporte de formato

Resumen

Este tutorial muestra cómo podemos crear PDF mediante programación utilizando la biblioteca IronPDF C#. Hemos visto cómo crear archivos PDF a partir de cadenas HTML, archivos HTML, URL y formularios web ASP.NET. La manipulación y el formateo de archivos PDF resultan muy sencillos con la función de biblioteca IronPDF. Todo lo que se necesita son unas pocas líneas de código para crear y formatear el archivo PDF mediante programación. IronPDF es ideal para desarrolladores y empresas que necesitan manipular archivos PDF dentro de su software.

Puedes probar la versión gratuita para realizar pruebas, y hay una clave de prueba gratuita disponible que no requiere pagos con tarjeta de crédito. Además, la oferta especial actual te permite obtener cinco productos de IronPDF por el precio de solo dos.

Chipego
Ingeniero de software
Chipego tiene una habilidad natural para escuchar que le ayuda a comprender los problemas de los clientes y a ofrecer soluciones inteligentes. Se unió al equipo de Iron Software en 2023, después de estudiar una licenciatura en Tecnología de la Información. IronPDF e IronOCR son los dos productos en los que Chipego se ha centrado, pero su conocimiento de todos los productos crece día a día, a medida que encuentra nuevas formas de ayudar a los clientes. Disfruta de lo colaborativa que es la vida en Iron Software, con miembros del equipo de toda la empresa que aportan su variada experiencia para contribuir a soluciones eficaces e innovadoras. Cuando Chipego está lejos de su escritorio, a menudo se le puede encontrar disfrutando de un buen libro o jugando al fútbol.
< ANTERIOR
Guía Completa del Generador de PDF en C#: Uso de IronPDF para la Creación y Manipulación de PDF sin Esfuerzo
SIGUIENTE >
Cómo abrir un archivo PDF en C#