C# Crear Archivo PDF Programáticamente

Antes de continuar, deberíamos instalar la biblioteca IronPdf en nuestro proyecto. Podemos hacer esto 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 Paquetes NuGet para la Solución. Esto abrirá el Explorador de Soluciones del Administrador de Paquetes NuGet.

Abrir Administrador de Paquetes NuGet

Haz clic en "Buscar" y escribe IronPDF en la barra de búsqueda. Aparecerá el siguiente resultado. Selecciona IronPdf y haz clic en el botón Instalar; la biblioteca empezará a instalarse.

Buscar e instalar paquete IronPdf

Método 2: Consola del gestor de paquetes NuGet

Podemos usar la Consola del Administrador de Paquetes NuGet para instalar rápidamente nuestra biblioteca. No requiere privilegios administrativos para instalar. Puedes usar un comando NuGet para instalar la biblioteca IronPdf en tu proyecto.

Install-Package IronPdf

Instalar paquete IronPdf vía Línea de Comando

Método 3: Utilizar un archivo DLL

La tercera forma de usar IronPDF en tu proyecto es agregar un archivo DLL de la biblioteca IronPDF. Puedes descargar el archivo DLL.

• Descarga el archivo zip del DLL. Extráelo en una carpeta específica.
• Abre un proyecto en Visual Studio. En el Explorador de Soluciones, haz clic derecho en Referencias y busca el archivo DLL de IronPDF.

Visita una guía de instalación más detallada sobre cómo instalar IronPDF.

Veremos múltiples métodos para crear PDFs usando IronPDF. Veremos qué tan fácil es usar funciones simples para crear archivos PDF. Comencemos con la creación de PDFs usando cadenas HTML.

4.1. Crear PDFs mediante programación utilizando cadenas HTML

En la biblioteca IronPDF, se usa HTML para propósitos de estilo. Debes tener conocimientos básicos del lenguaje HTML para generar documentos PDF usando la biblioteca IronPDF.

La biblioteca IronPDF hace que sea muy fácil procesar cadenas HTML y convertirlas en formato PDF. Veamos cómo hacerlo usando código.

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

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

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

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

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

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

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")

Este código generará un archivo PDF que contiene 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 Cadenas HTML a un documento PDF.

Debes estar familiarizado con las etiquetas HTML para generar archivos PDF usando la biblioteca IronPDF. La función SaveAs se usa para guardar el archivo PDF de salida. Puedes ver el archivo PDF de salida a continuación.

Output:

Salida de archivo PDF

4.2. Crear PDF mediante programación utilizando archivos HTML

La biblioteca IronPDF proporciona una característica fantástica para crear un archivo PDF a partir de un archivo HTML. IronPDF convierte directamente todo en un archivo HTML, incluidos imágenes, CSS, formularios, etc., en un documento PDF. No requiere ninguna otra biblioteca o función para un procesamiento adicional. IronPDF convierte directamente cualquier archivo HTML a un archivo PDF.

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

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert an HTML file to a PDF and save it
Dim pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf")

Usamos la función RenderHtmlFileAsPdf para crear PDFs a partir de archivos HTML. Puedes dar 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, solo necesitarás poner el nombre del archivo con extensión en el parámetro de la función RenderHtmlFileAsPdf. El archivo PDF de salida se guardará en la carpeta bin cuando ejecutes este código. La función SaveAs ayuda a guardar los archivos PDF creados.

4.3. Crear PDFs mediante programación utilizando URLs

A veces necesitamos crear archivos PDF de una URL de manera programada en nuestro programa. Esto puede ser una tarea muy técnica si codificamos todo desde cero. IronPDF nos ayuda aquí al proporcionar una excelente función para crear PDFs a partir de URLs. Puedes usar cualquier URL para crear un PDF.

Veamos cómo hacerlo:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
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";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
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"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert a URL to a PDF and save it
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")

El código anterior creará un PDF del parámetro URL dado a la función RenderUrlAsPdf. Esta función crea un PDF de la URL. Esto sería una tarea muy compleja si intentaras hacerlo desde cero, así que IronPDF proporciona a los desarrolladores un proceso simple para convertir cualquier URL a un PDF. La función SaveAs se usa para guardar archivos de salida en la carpeta bin. Para establecer el formato del archivo en PDF, debes especificar una extensión .pdf con un parámetro de nombre de archivo en la función SaveAs. Puedes ver la carpeta bin en tu carpeta de proyecto. La salida se muestra a continuación.

Output:

Crear archivo PDF desde URL

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

ASP.NET es un marco de programación del lado del servidor que extiende la funcionalidad de HTML y admite 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 amigables para el usuario, ricos en funcionalidad, banca en línea, intranets y sistemas contables.

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

Veamos cómo hacerlo:

1. Crea un proyecto de formulario web ASP.NET en Visual Studio. Se recomienda la última versión de Visual Studio.
2. Instala la biblioteca IronPDF usando el Administrador de Paquetes NuGet o el archivo DLL según tu elección. También puedes usar la Consola del Administrador de Paquetes NuGet para instalarlo.
3. Ahora, abre el código de cualquier página web ASPX que desees convertir en un archivo PDF. Aquí crearemos un PDF de la página Default.aspx del proyecto.

Estructura del proyecto Web Form en Visual Studio

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

using IronPdf;

using IronPdf;

Imports IronPdf

5. Escribe 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);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser)

¡Y eso es todo! Se ha creado un archivo PDF de la página web ASPX. Cuando ejecutes el proyecto, verás un PDF de la página web en el navegador. El resultado es el mismo que cuando haces un PDF presionando Ctrl+P. Aquí no necesitabas presionar Ctrl+P para crear un PDF del archivo ASPX.

Esto se ha hecho del lado del servidor. En este código, usamos 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 a nuestro sistema agregando la siguiente línea de código en la función Page_Load:

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

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

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 ASPX. Hay múltiples opciones disponibles para modificaciones y formateo, como encabezados, pies de página, opciones de impresión, calidad, etc. Para más detalles, visita este tutorial completo de ASPX a PDF.

Output:

Resultado 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.5. Crear PDF programáticamente con formato

Al crear PDFs, se encuentran la mayoría de los problemas durante el formateo de los documentos PDF. No es fácil formatear PDFs de manera programada. Pero ahora tenemos una solución en la forma de IronPDF. IronPDF asiste con varias opciones de formateo para permitirnos personalizar el archivo PDF que estamos creando. Nos proporciona métodos para agregar encabezados, pies de página, márgenes y muchas otras opciones de formateo.

Usar 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 del tamaño de la fuente, el color de la fuente, el tipo de fuente y otras operaciones relacionadas con la fuente. Puedes agregar pies de página y encabezados con una línea divisoria y texto personalizado. Veamos cómo personalizar archivos PDF usando IronPDF.

• Crear un proyecto de consola en C#. También puedes crear un proyecto GUI, dependiendo de tus necesidades. También puedes abrir proyectos existentes.
• Instalar la biblioteca IronPDF usando el Administrador de Paquetes NuGet o el archivo DLL.
• Agrega el espacio de nombres IronPDF al inicio del archivo.

Nuestra configuración de la aplicación ahora está completada. A continuación, agrega el siguiente código al archivo PDF:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
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 Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

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

// Footer Settings
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}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
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 Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

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

// Footer Settings
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}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer As ChromePdfRenderer = New IronPdf.ChromePdfRenderer()

' Configure rendering options
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 Settings
renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40

renderer.RenderingOptions.FirstPageNumber = 1

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

' Footer Settings
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}"

' HTML content to be converted into a PDF
Dim htmlStr As String = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>"

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf")

Este fragmento de código está formateando 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 el encabezado del archivo PDF. Puedes acceder a más propiedades para el encabezado 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 texto, lado derecho e izquierdo del pie de página, tamaño de fuente y muchas otras.
• renderer.RenderingOptions.PaperOrientation
  • Esta línea de código permite al usuario establecer la orientación de la página (horizontal o vertical) del archivo PDF.
• renderer.RenderingOptions.Title
  • Podemos usar esta línea para establecer el título del archivo PDF.

En las últimas líneas, usamos la función RenderHtmlAsPdf para crear un PDF de una Cadena HTML, pero podemos usar un archivo HTML para convertirlo de manera fluida en PDF mientras preservamos el formato actual. Esta es una característica muy práctica de IronPDF que te da total libertad para personalizar todo lo relacionado con documentos PDF.

Output:

Salida de PDF con soporte de formato