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

Instalación mediante el gestor de paquetes NuGet

La forma más rápida de agregar IronPDF a tu proyecto ASP.NET para convertir HTML a PDF es a través del Administrador de Paquetes NuGet en Visual Studio. Haz clic derecho en tu proyecto en el Explorador de Soluciones, selecciona 'Administrar paquetes NuGet' y busca IronPDF. Haz clic en Instalar en la última versión para agregarlo a tu proyecto. Para obtener instrucciones de instalación detalladas, consulte la guía de instalación de IronPDF.

Install-Package IronPdf

Cómo convertir ASP HTML a PDF en .NET Core utilizando IronPDF: Imagen 3 - Instalación

Añadir espacios de nombres necesarios

Una vez instalado, agrega el espacio de nombres de IronPDF a cualquier archivo C# en el que trabajes con la generación de PDF:

using IronPdf;

using IronPdf;

Imports IronPdf

Esta simple declaración de importación le da acceso a toda la funcionalidad de IronPDF, incluyendo la clase ChromePdfRenderer para la conversión HTML y varias opciones de configuración para personalizar su salida PDF.

Cómo convertir ASP HTML a PDF en .NET Core utilizando IronPDF: Imagen 4 - ASP HTML to PDF - IronPDF

Configuración básica

Para la mayoría de las aplicaciones ASP.NET Core, IronPDF funciona inmediatamente después de la instalación sin configuración adicional. Sin embargo, puedes establecer opciones globales en tu archivo Program.cs o Startup.cs:

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

IRON VB CONVERTER ERROR developers@ironsoftware.com

Estas opciones de configuración ayudan a optimizar IronPDF para tu entorno de hospedaje específico, ya sea que estés ejecutando en Windows, Linux o en contenedores Docker. Asegúrate de que tanto los scripts como los archivos de la aplicación no residan en el mismo directorio para prevenir conflictos.

Cómo convertir ASP HTML a PDF en .NET Core utilizando IronPDF: Imagen 5 - Compatibilidad entre plataformas

Resultado

Cómo convertir ASP HTML a PDF en .NET Core utilizando IronPDF: Imagen 6 - PDF Output

Trabajo con CSS e imágenes

IronPDF soporta completamente el estilo CSS y puede incrustar imágenes de varias fuentes al convertir HTML a PDF. El convertidor de PDF maneja elementos HTML con total fidelidad, incluidos varios etiquetas HTML y URLs de imágenes:

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

El renderizador procesa estilos en línea, archivos CSS e incluso imágenes codificadas en base64. Esto asegura que tus páginas PDF mantengan la apariencia exacta de tu contenido HTML, incluyendo características modernas de CSS3 como flexbox y cuadrículas. La conversión de HTML a PDF preserva todas las etiquetas HTML y su estilo sin generar páginas en blanco.

Conversión de vistas de controlador

En su controlador ASP.NET Core, puede renderizar una vista a HTML y luego convertirla en un documento PDF utilizando la potente biblioteca PDF de IronPDF capacidades de renderización:

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Este enfoque convierte primero la vista Razor en una cadena HTML y, a continuación, la convierte en PDF. El PDF se devuelve como una descarga de archivo al navegador del usuario con un nombre de archivo adecuado. Esto funciona a la perfección ya sea que estés convirtiendo un archivo ASPX o vistas Razor modernas.

Resultado

Cómo convertir ASP HTML a PDF en .NET Core utilizando IronPDF: Imagen 7 - Controller View Output

Convertir URL en PDF

Para las páginas web existentes, puedes usar IronPDF como un poderoso convertidor de HTML a PDF para transformar cualquier URL especificada directamente en archivos PDF. Simplemente proporciona una dirección HTTP o HTTPS como parámetro de URL:

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Este método es particularmente útil cuando ya tienes páginas web bien formateadas y deseas ofrecerlas como una versión en PDF descargable. La biblioteca .NET maneja todos los recursos externos, incluidas hojas de estilo, scripts e imágenes, asegurando un renderizado HTML completo. El convertidor devolverá un código de estado HTTP adecuado si encuentra una URL no válida.

Resultado

Cómo convertir ASP HTML a PDF en .NET Core utilizando IronPDF: Imagen 8 - URL to PDF Output

Manejo de la autenticación

Al convertir páginas autenticadas mediante la autenticación de formularios de .NET u otros mecanismos de seguridad, puedes pasar cookies o encabezados para mantener la misma sesión de usuario. Esto previene la redirección a una pantalla de inicio de sesión durante la conversión de PDF:

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Esto asegura que el contenido HTML protegido pueda ser convertido a archivos PDF manteniendo la seguridad. El proceso de conversión de PDF respeta la autenticación básica y de formularios de tu aplicación, previniendo el acceso no autorizado de cuentas de usuario a documentos existentes sensibles. También puedes pasar argumentos de nombre de usuario y contraseña cuando sea necesario para escenarios de autenticación básica.

Configuración de página y márgenes

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

IRON VB CONVERTER ERROR developers@ironsoftware.com

Estas configuraciones controlan el diseño físico de tus páginas PDF, incluidas tanto las páginas impares como las pares. Puedes elegir entre tamaños de papel estándar o definir dimensiones personalizadas, establecer orientación vertical o horizontal, y ajustar márgenes para que coincidan con tus requisitos de diseño en varias páginas. El sistema de plantillas gráficas asegura un estilo consistente a través de las páginas impares y pares subsiguientes.

Resultado

Cómo convertir ASP HTML a PDF en .NET Core utilizando IronPDF: Imagen 9 - Salida PDF Personalizada

Cabeceras y pies de página

Agregar encabezados y pies de página consistentes mejora la apariencia profesional de tus documentos PDF al convertir documentos HTML:

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

IRON VB CONVERTER ERROR developers@ironsoftware.com

Los encabezados y pies de página soportan elementos HTML y formato con marcadores especiales para números de página, fechas y otro contenido dinámico en todas las páginas PDF. El siguiente código demuestra cómo agregar encabezados profesionales a tu documento generado dinámicamente o documentos PDF existentes.