USO DE IRONPDF

C# Crear archivo PDF mediante programación

Actualizado 10 de marzo, 2022
Compartir:

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 librería IronPdf Library
    • 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: Añadir 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

El IronPDF es un Biblioteca PDF en C# que proporciona un conjunto de clases que pueden utilizarse para crear archivos PDF mediante programación. Estas clases se encuentran en el ensamblado `IronPdf`` y están diseñadas para facilitar su uso con cualquier lenguaje .NET, incluidos C#, VB.NET, F#, etc. La biblioteca ofrece muchas funciones para crear documentos PDF, manipular PDF existentes y leer PDF.

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

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 librería IronPdf en nuestro proyecto. Podemos hacerlo de varias maneras.

Método 1: Gestor de paquetes NuGet

Podemos instalar la librería IronPdf C# Library desde el gestor de paquetes NuGet. Abra el Gestor de paquetes NuGet haciendo clic en Herramientas > Gestor de paquetes NuGet > Gestionar solución de paquetes NuGet. Esto abrirá el Explorador de soluciones del Gestor de paquetes NuGet.

C# Crear archivo PDF mediante programación, Figura 1: Abrir el gestor de paquetes NuGet

**Abrir el gestor 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 mediante programación, Figura 2: Buscar e instalar el paquete IronPdf

Busca e instala 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. Utilizarás un comando NuGet para instalar la librería IronPdf en tu proyecto.

Install-Package IronPdf

C# Crear archivo PDF mediante programación, Figura 3: Instalar el paquete IronPdf mediante línea de comandos

Instalar el paquete 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. Puede descargar el archivo DLL.

  • Descargue el archivo zip DLL. Extráelo a una carpeta específica.
  • Abra un proyecto en Visual Studio. En el Explorador de soluciones, haga clic con el botón derecho en Referencias y busque el archivo DLL IronPDF.

    Visite más guía detallada de instalación.

Paso 3: Añadir el espacio de nombres `IronPdf

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

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

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");
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");
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")
VB   C#

Este código generará un archivo PDF con el contenido almacenado en la variable htmlString. En este ejemplo de código, el RenderHtmlAsPdf se ha utilizado la función 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 mediante programación, Figura 4: Salida del archivo PDF

**Salida de archivos 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:

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Utilizamos el RenderHtmlFileAsPdf para crear archivos PDF a partir de archivos HTML. Esta función es la más importante utilizada en el código de ejemplo. Puede dar la ubicación del archivo HTML en el parámetro de la función o poner el archivo HTML en la carpeta bin del código fuente, por lo que sólo tendrá que 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:

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

El código anterior creará un PDF del parámetro URL dado a la carpeta RenderUrlAsPdf función. 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 mediante programación, Figura 5: Crear archivo PDF a partir de URL

**Crear un archivo PDF a partir de una 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 se escriben en HTML, CSS y JavaScript, y pueden codificarse 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 mediante programación, Figura 6: Estructura del proyecto Web Form en Visual Studio

    **Estructura del proyecto de formulario web en Visual Studio

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

    usando 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 Aspx PDF. 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, visite esta página enlace.

    Salida:

    C# Crear archivo PDF mediante programación, Figura 7: Salida de la representación de un archivo PDF desde el servidor

    Salida de la renderización de un archivo PDF desde el servidor

    Explore la última tecnología de Microsoft Aplicación 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:

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;

//Ajuste de márgenes
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Ajuste de la cabecera
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.FontFamily = "Helvetica,Arial";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Configuración del pie de página
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");
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;

//Ajuste de márgenes
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Ajuste de la cabecera
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.FontFamily = "Helvetica,Arial";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Configuración del pie de página
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");
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

'Ajuste de márgenes
Renderer.RenderingOptions.MarginTop = 40
Renderer.RenderingOptions.MarginLeft = 20
Renderer.RenderingOptions.MarginRight = 20
Renderer.RenderingOptions.MarginBottom = 40

Renderer.RenderingOptions.FirstPageNumber = 1

'Ajuste de la cabecera
Renderer.RenderingOptions.TextHeader.DrawDividerLine = True
Renderer.RenderingOptions.TextHeader.CenterText = "Header!"
Renderer.RenderingOptions.TextHeader.FontFamily = "Helvetica,Arial"
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica

'Configuración del pie de página
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")
VB   C#

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 de la cadena HTML, pero podemos utilizar una función HTML para convertirlo en PDF conservando 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 mediante programación, Figura 8: Salida PDF con soporte de formato

    Salida 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 de 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 comprobarlo, y hay una llave de prueba gratuita que no requiere ningún pago con tarjeta de crédito. Además, la oferta especial actual le permite obtener cinco productos de IronPDF por el precio de sólo dos.

< ANTERIOR
Cómo crear un generador de PDF en C#
SIGUIENTE >
Cómo abrir un archivo PDF en C#

¿Listo para empezar? Versión: 2024.6 recién publicada

Comenzar prueba gratuita Descargas totales: 9,602,420
Ver licencias >