Cómo generar PDF en .NET Core con IronPDF

¿Cómo genera .NET Core archivos PDF?

IronPDF utiliza un motor de renderizado basado en Chrome para convertir contenido HTML en archivos PDF. Este enfoque significa que puede usar sus conocimientos existentes de HTML y CSS para crear archivos PDF sin tener que aprender API de PDF complejas y de bajo nivel ni tener que afrontar una curva de aprendizaje pronunciada. La biblioteca maneja la conversión automática de páginas web, admite la ejecución de JavaScript y diseños CSS responsivos.

La API de la biblioteca le permite generar documentos PDF a partir de cadenas HTML, URL o archivos HTML locales. Al convertir HTML a PDF, IronPDF conserva diseños complejos, estilos CSS, ejecución de JavaScript y contenido web dinámico. Esto lo convierte en una opción práctica para los desarrolladores .NET que necesitan capacidades confiables de conversión de PDF en sus aplicaciones.

El proceso de renderizado utiliza la misma tecnología que impulsa Google Chrome, lo que garantiza que las conversiones de HTML a PDF coincidan con lo que los usuarios ven en los navegadores modernos. Esto incluye soporte para funciones CSS3, fuentes web, gráficos SVG y sistemas de diseño modernos como Flexbox y CSS Grid. Debido a que el motor de renderizado está basado en Chrome, el resultado es predecible y consistente en los entornos de desarrollo, preparación y producción.

¿Cómo instalar IronPDF en un proyecto .NET 10?

Para comenzar se requiere una única instalación a través del Administrador de paquetes NuGet . Tiene dos opciones dependiendo de su flujo de trabajo.

Opción 1: Consola del administrador de paquetes en Visual Studio

Install-Package IronPdf

Install-Package IronPdf

Opción 2: CLI .NET

dotnet add package IronPdf

dotnet add package IronPdf

Para una guía de instalación paso a paso, consulte Guía de instalación de NuGet.

Para implementaciones de Docker o entornos Linux, es posible que se requieran dependencias del sistema adicionales. IronPDF es compatible con macOS, Windows, Linux, Azure y AWS Lambda, lo que lo hace adaptable a diversos escenarios de alojamiento. Después de la instalación, agregue una clave de licencia de prueba para desbloquear el conjunto completo de funciones durante el desarrollo. La prueba es gratuita y no requiere tarjeta de crédito, por lo que puede evaluar la biblioteca completamente antes de comprar una licencia comercial.

¿Cómo generar un PDF a partir de una cadena HTML?

La forma más directa de crear un PDF es convirtiendo contenido HTML. A continuación se muestra un ejemplo mínimo que utiliza declaraciones de nivel superior de C#:

using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>");

// Save to disk
pdf.SaveAs("hello.pdf");

using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>");

// Save to disk
pdf.SaveAs("hello.pdf");

Imports IronPdf

' Instantiate the renderer
Dim renderer As New ChromePdfRenderer()

' Convert an HTML string to PDF
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>")

' Save to disk
pdf.SaveAs("hello.pdf")

La clase ChromePdfRenderer se encarga del proceso de conversión. El objeto PdfDocument devuelto le da acceso a datos binarios, recuento de páginas y opciones de salida como guardar en un archivo o en un flujo de memoria. También puede adjuntar metadatos como título, autor y palabras clave del tema al archivo de salida.

El renderizador admite una amplia gama de opciones de renderizado. Puede configurar márgenes personalizados, establecer tamaños de papel, controlar la orientación de la página y ajustar las dimensiones de la ventana gráfica. Estas opciones garantizan que la salida PDF cumpla con los requisitos de formato específicos para documentos profesionales.

using IronPdf;

var html = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; font-size: 14px; }
        .invoice-header {
            background-color: #2c3e50;
            color: white;
            padding: 20px;
        }
        .invoice-details { margin: 20px 0; }
        table { width: 100%; border-collapse: collapse; }
        th, td {
            padding: 12px;
            text-align: left;
            border-bottom: 1px solid #ddd;
        }
        .total {
            font-size: 1.2em;
            font-weight: bold;
            text-align: right;
        }
    </style>
</head>
<body>
    <div class='invoice-header'>
        <h1>Invoice #2026-001</h1>
        <p>Date: February 28, 2026</p>
    </div>
    <div class='invoice-details'>
        <h3>Bill To: Jane Smith</h3>
        <table>
            <tr>
                <th>Item</th>
                <th>Quantity</th>
                <th>Price</th>
            </tr>
            <tr>
                <td>Professional License</td>
                <td>1</td>
                <td>$749.00</td>
            </tr>
        </table>
        <p class='total'>Total: $749.00</p>
    </div>
</body>
</html>";

var renderer = new ChromePdfRenderer();

// Apply custom margins
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("invoice.pdf");

using IronPdf;

var html = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; font-size: 14px; }
        .invoice-header {
            background-color: #2c3e50;
            color: white;
            padding: 20px;
        }
        .invoice-details { margin: 20px 0; }
        table { width: 100%; border-collapse: collapse; }
        th, td {
            padding: 12px;
            text-align: left;
            border-bottom: 1px solid #ddd;
        }
        .total {
            font-size: 1.2em;
            font-weight: bold;
            text-align: right;
        }
    </style>
</head>
<body>
    <div class='invoice-header'>
        <h1>Invoice #2026-001</h1>
        <p>Date: February 28, 2026</p>
    </div>
    <div class='invoice-details'>
        <h3>Bill To: Jane Smith</h3>
        <table>
            <tr>
                <th>Item</th>
                <th>Quantity</th>
                <th>Price</th>
            </tr>
            <tr>
                <td>Professional License</td>
                <td>1</td>
                <td>$749.00</td>
            </tr>
        </table>
        <p class='total'>Total: $749.00</p>
    </div>
</body>
</html>";

var renderer = new ChromePdfRenderer();

// Apply custom margins
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("invoice.pdf");

Imports IronPdf

Dim html As String = "
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; font-size: 14px; }
        .invoice-header {
            background-color: #2c3e50;
            color: white;
            padding: 20px;
        }
        .invoice-details { margin: 20px 0; }
        table { width: 100%; border-collapse: collapse; }
        th, td {
            padding: 12px;
            text-align: left;
            border-bottom: 1px solid #ddd;
        }
        .total {
            font-size: 1.2em;
            font-weight: bold;
            text-align: right;
        }
    </style>
</head>
<body>
    <div class='invoice-header'>
        <h1>Invoice #2026-001</h1>
        <p>Date: February 28, 2026</p>
    </div>
    <div class='invoice-details'>
        <h3>Bill To: Jane Smith</h3>
        <table>
            <tr>
                <th>Item</th>
                <th>Quantity</th>
                <th>Price</th>
            </tr>
            <tr>
                <td>Professional License</td>
                <td>1</td>
                <td>$749.00</td>
            </tr>
        </table>
        <p class='total'>Total: $749.00</p>
    </div>
</body>
</html>"

Dim renderer As New ChromePdfRenderer()

' Apply custom margins
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10

Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("invoice.pdf")

¿Cómo convertir una URL de página web a PDF?

IronPDF puede generar archivos PDF a partir de páginas web en vivo pasando una URL al renderizador. Esto es útil cuando necesitas capturar contenido web de forma dinámica o archivar una página pública:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure viewport and JavaScript settings
renderer.RenderingOptions.ViewPortWidth = 1920;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
renderer.RenderingOptions.WaitFor.RenderDelay(1500); // Allow dynamic content to load

// Render the URL to PDF
var pdf = renderer.RenderUrlAsPdf("https://example.com");

// Save to disk
pdf.SaveAs("webpage.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure viewport and JavaScript settings
renderer.RenderingOptions.ViewPortWidth = 1920;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
renderer.RenderingOptions.WaitFor.RenderDelay(1500); // Allow dynamic content to load

// Render the URL to PDF
var pdf = renderer.RenderUrlAsPdf("https://example.com");

// Save to disk
pdf.SaveAs("webpage.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Configure viewport and JavaScript settings
renderer.RenderingOptions.ViewPortWidth = 1920
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen
renderer.RenderingOptions.WaitFor.RenderDelay(1500) ' Allow dynamic content to load

' Render the URL to PDF
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")

' Save to disk
pdf.SaveAs("webpage.pdf")

La configuración RenderDelay garantiza que el contenido basado en JavaScript (gráficos, imágenes de carga lenta, tablas dinámicas) termine de renderizarse antes de que se capture el PDF. También puede configurar las condiciones WaitFor para esperar a que se completen determinados elementos del DOM o solicitudes de red. Para las páginas detrás de la autenticación, la biblioteca admite encabezados de solicitud HTTP y cookies personalizadas.

Para aplicaciones complejas de una sola página creadas con Angular o React, las condiciones de espera adicionales ayudan a garantizar que toda la representación del lado del cliente se complete antes de que se tome la instantánea en PDF.

¿Cómo integrar la generación de PDF en un controlador ASP.NET Core ?

Generar archivos PDF dentro de una API web ASP.NET Core es sencillo. El siguiente ejemplo muestra una acción de controlador que crea un informe HTML y lo devuelve como una descarga de archivo:

using Microsoft.AspNetCore.Mvc;
using IronPdf;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("generate-report")]
    public IActionResult GenerateReport()
    {
        var html = @"
            <h1>Monthly Sales Report</h1>
            <p>Generated on: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            <table>
                <tr><th>Product</th><th>Sales</th></tr>
                <tr><td>Product A</td><td>$5,000</td></tr>
                <tr><td>Product B</td><td>$3,500</td></tr>
            </table>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);

        // Return the PDF bytes as a downloadable file
        return File(pdf.BinaryData, "application/pdf", "monthly-report.pdf");
    }
}

using Microsoft.AspNetCore.Mvc;
using IronPdf;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("generate-report")]
    public IActionResult GenerateReport()
    {
        var html = @"
            <h1>Monthly Sales Report</h1>
            <p>Generated on: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            <table>
                <tr><th>Product</th><th>Sales</th></tr>
                <tr><td>Product A</td><td>$5,000</td></tr>
                <tr><td>Product B</td><td>$3,500</td></tr>
            </table>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);

        // Return the PDF bytes as a downloadable file
        return File(pdf.BinaryData, "application/pdf", "monthly-report.pdf");
    }
}

Imports Microsoft.AspNetCore.Mvc
Imports IronPdf

<ApiController>
<Route("api/[controller]")>
Public Class PdfController
    Inherits ControllerBase

    <HttpGet("generate-report")>
    Public Function GenerateReport() As IActionResult
        Dim html As String = "
            <h1>Monthly Sales Report</h1>
            <p>Generated on: " & DateTime.Now.ToString("MMMM dd, yyyy") & "</p>
            <table>
                <tr><th>Product</th><th>Sales</th></tr>
                <tr><td>Product A</td><td>$5,000</td></tr>
                <tr><td>Product B</td><td>$3,500</td></tr>
            </table>"

        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(html)

        ' Return the PDF bytes as a downloadable file
        Return File(pdf.BinaryData, "application/pdf", "monthly-report.pdf")
    End Function
End Class

El tipo de retorno File() indica a ASP.NET Core que transmita los bytes PDF sin procesar al navegador del cliente con el tipo MIME correcto. El cliente recibe un PDF descargable sin ningún archivo intermedio en el disco. Puede agregar encabezados y pies de página a cada página, o aplicar marcas de agua para borradores o documentos confidenciales.

Para aplicaciones de producción, considere usar la generación de PDF asincrónica para mantener el flujo de solicitudes sin bloqueos, en particular al generar documentos grandes o complejos.

[HttpGet]
public async Task<IActionResult> DownloadInvoice(int id)
{
    // Fetch invoice data from the database
    var model = await GetInvoiceData(id);

    // Render the Razor view to an HTML string
    var html = await RenderViewToString("Invoice", model);

    // Convert the rendered HTML a PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Return the file to the browser
    return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
}

[HttpGet]
public async Task<IActionResult> DownloadInvoice(int id)
{
    // Fetch invoice data from the database
    var model = await GetInvoiceData(id);

    // Render the Razor view to an HTML string
    var html = await RenderViewToString("Invoice", model);

    // Convert the rendered HTML a PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Return the file to the browser
    return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
}

Imports System.Threading.Tasks
Imports Microsoft.AspNetCore.Mvc

<HttpGet>
Public Async Function DownloadInvoice(id As Integer) As Task(Of IActionResult)
    ' Fetch invoice data from the database
    Dim model = Await GetInvoiceData(id)

    ' Render the Razor view to an HTML string
    Dim html = Await RenderViewToString("Invoice", model)

    ' Convert the rendered HTML to a PDF
    Dim renderer = New ChromePdfRenderer()
    Dim pdf = renderer.RenderHtmlAsPdf(html)

    ' Return the file to the browser
    Return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf")
End Function

¿Cómo empezar a utilizar IronPDF en .NET 10?

IronPDF hace que la generación de PDF en .NET Core sea sencilla. Su motor de renderizado Chrome garantiza una fidelidad precisa al crear archivos PDF a partir de contenido HTML, mientras que el diseño de API elimina la complejidad típica asociada con la manipulación de PDF. La biblioteca proporciona documentación completa para todas las funciones y admite la implementación en Windows, Linux, macOS, Azure Functions, AWS Lambda y contenedores Docker.

Ya sea que esté creando facturas, informes o herramientas de gestión de documentos, IronPDF proporciona las herramientas necesarias para la creación profesional de PDF. Revise la lista completa de funciones para comprender el alcance total de las capacidades de la biblioteca o verifique las opciones de licencia adecuadas para desarrolladores individuales y equipos empresariales.

Comience hoy una prueba gratuita para probar IronPDF en su propio proyecto .NET 10. La licencia de prueba cubre el conjunto completo de funciones para que pueda evaluar la generación de PDF, la fusión, la firma, el llenado de formularios y la extracción de texto antes de comprometerse con una licencia.

Para obtener más contexto, explore la documentación de IronPDF para encontrar referencias de API, guías de plataforma y ejemplos de código que cubren escenarios comunes de PDF .NET .

Referencias externas:

• Documentación de Microsoft .NET
• Registro de paquetes NuGet para IronPDF Chrome para desarrolladores: Chrome sin interfaz gráfica