Cómo Convertir HTML a PDF en ASP .NET usando C#

Cómo convertir HTML a PDF en ASP.NET con IronPDF

1. Crea un proyecto de ASP.NET usando Visual Studio o tu IDE de preferencia.
2. Instala IronPDF y configura tu clave de licencia.
3. Crea un nuevo controlador o página donde quieras manejar la conversión a PDF.
4. Escribe tu lógica de conversión dentro del controlador.
5. Configura el routing para permitir el acceso a tu acción de generación de PDF.

Descripción general de IronPDF

IronPDF es una biblioteca PDF poderosa que permite a los desarrolladores leer, crear y manipular documentos PDF. Con un conjunto de características rico y un proceso de instalación rápido y simple, puedes llevar tus proyectos PDF al siguiente nivel en poco tiempo gracias a IronPDF. Su API intuitiva es fácil de aprender, convirtiéndola en una elección ideal si buscas generar documentos PDF dinámicos, realizar tareas de seguridad en PDF, anotaciones en PDF, etc., directamente desde tu aplicación web.

Requisitos previos

Antes de comenzar, asegúrate de tener:

• Visual Studio u otro entorno de desarrollo de C# configurado.
• Biblioteca IronPDF instalada. Puedes obtenerla de NuGet o directamente del sitio web de IronPDF.

Crear un nuevo proyecto ASP.NET

Inicia Visual Studio y selecciona el tipo de proyecto ASP.NET que mejor se adapte a tus necesidades. Para el ejemplo de hoy, crearé una Aplicación Web ASP.NET Core (Controlador Modelo-vista).

Luego, ingresa el nombre para tu proyecto y elige la ubicación para alojarlo.

Finalmente, elige tu .NET Framework para el proyecto y cambia cualquier configuración adicional para el proyecto, como el tipo de autenticación, o habilitar el soporte para contenedores y docker.

Añadir código de conversión de HTML a PDF

Ahora que hemos creado nuestro proyecto ASP.NET, podemos comenzar a escribir el código para convertir el contenido de un archivo HTML a un PDF. Comenzaremos con un ejemplo sencillo de cadena HTML a PDF, antes de ver cómo convertir contenido HTML con personalización.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace IronPdfTest.Controllers
	Public Class PdfController
		Inherits Controller

		' Action method to generate a PDF from HTML content
		Public Function GeneratePdf() As IActionResult
			' String of HTML code to be converted to PDF
			Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"

			' Creating a renderer to convert the HTML string to PDF
			Dim renderer As New ChromePdfRenderer()

			' Convert HTML string to PDF
			Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

			' Return the generated PDF file
			Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
		End Function
	End Class
End Namespace

ASP.NET MVC utiliza controladores para manejar las solicitudes de los usuarios. Cuando un usuario navega a una URL específica, ASP.NET llamará a un método en el controlador asociado a esa ruta.

• PdfController es una clase que hereda de Controller, lo que significa que puede manejar solicitudes web y enviar respuestas.
• El método GeneratePdf dentro de este controlador, manejará una solicitud para convertir HTML en un PDF y devolver el resultado.

Cuando un usuario visita una URL vinculada a la acción GeneratePdf, el método se ejecuta.

• IActionResult: Este es el tipo de retorno, que representa la respuesta que la aplicación web enviará de vuelta al usuario. Podría ser una vista (página HTML), descarga de archivo, etc. En este caso, es un archivo PDF.

  • Método GeneratePdf():

  • Dentro del método, definimos una cadena htmlContent que contiene el HTML que quieres convertir a PDF. For example, "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>".

• Creamos una nueva instancia de ChromePdfRenderer, que maneja la conversión de HTML a PDF.

• El método RenderHtmlAsPdf() toma la cadena HTML y devuelve un objeto PDF.

Perfiles PDF personalizados

Ahora que hemos cubierto lo básico, veamos cómo crear un archivo PDF a partir de contenido HTML con algunas configuraciones de personalización para el PDF de salida. IronPDF proporciona un poderoso conjunto de herramientas de personalización para PDF, como márgenes, encabezados/pies de página, tamaño personalizado para PDF, y más.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace IronPdfTest.Controllers
	' Controller for our PDF converter
	Public Class PdfController
		Inherits Controller

		' Action method to generate a customized PDF from HTML content
		Public Function GeneratePdf() As IActionResult
			' String of HTML code to be converted to PDF
			Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"

			' Creating a renderer to convert the URL to PDF
			Dim renderer As New ChromePdfRenderer()

			' Creating the cover page
			Dim cover As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>")

			' Adding custom options for our final PDF
			renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape
			renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3
			renderer.RenderingOptions.TextHeader.CenterText = "IronPDF"
			renderer.RenderingOptions.TextHeader.FontSize = 12
			renderer.RenderingOptions.MarginTop = 20
			renderer.RenderingOptions.FirstPageNumber = 2

			' Creating our main PDF
			Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

			' Appending the cover to the main PDF
			pdf.InsertPdf(cover, 0)

			' Return the customized generated PDF file
			Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
		End Function
	End Class
End Namespace

Conclusión

Hoy hemos observado más de cerca cómo se puede usar la conversión de HTML a PDF con ASP.NET, y exploramos el proceso de creación de archivos PDF a partir de HTML dentro de un proyecto ASP.NET. Siguiendo los pasos descritos arriba, puedes integrar fácilmente la generación de PDF en tus aplicaciones web, permitiéndote crear documentos imprimibles de alta calidad a partir de contenido HTML.

IronPDF cuenta con un conjunto rico de características que se pueden aprovechar para producir documentos PDF de alta calidad. Para características más avanzadas y personalización detallada, consulta la documentación de IronPDF. Con su rápida instalación, puedes tener IronPDF configurado dentro de tu proyecto en poco tiempo.