Cómo convertir HTML a PDF en C# (Guía del desarrollador)

Cómo convertir una cadena HTML a PDF

La operación más fundamental es convertir una cadena HTML a PDF. Este método es perfecto para contenido HTML generado dinámicamente. El método RenderHtmlAsPdf soporta completamente HTML5, CSS3, JavaScript e imágenes cuando convierte HTML a PDF directamente.

using IronPdf;

// Create the Chrome renderer
var renderer = new ChromePdfRenderer();

// Convert HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>");

// Save the PDF
pdf.SaveAs("output.pdf");

using IronPdf;

// Create the Chrome renderer
var renderer = new ChromePdfRenderer();

// Convert HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>");

// Save the PDF
pdf.SaveAs("output.pdf");

Imports IronPdf

' Create the Chrome renderer
Dim renderer As New ChromePdfRenderer()

' Convert HTML string to PDF
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>")

' Save the PDF
pdf.SaveAs("output.pdf")

Cuando su cadena HTML hace referencia a activos locales como imágenes o hojas de estilo, use el parámetro BaseUrlPath para convertir adecuadamente contenido HTML con todos los recursos:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert HTML content with local image and CSS references
string html = @"
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>";

// Set base path for resolving relative URLs in HTML to PDF conversion
var pdf = renderer.RenderHtmlAsPdf(html, @"C:\MyProject\Assets\");
pdf.SaveAs("report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert HTML content with local image and CSS references
string html = @"
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>";

// Set base path for resolving relative URLs in HTML to PDF conversion
var pdf = renderer.RenderHtmlAsPdf(html, @"C:\MyProject\Assets\");
pdf.SaveAs("report.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Convert HTML content with local image and CSS references
Dim html As String = "
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>"

' Set base path for resolving relative URLs in HTML to PDF conversion
Dim pdf = renderer.RenderHtmlAsPdf(html, "C:\MyProject\Assets\")
pdf.SaveAs("report.pdf")

RELATED HOW-TO ARTICLE: How to Convert HTML String to PDF in C#

Cómo exportar una URL existente a PDF

Renderizar páginas web completas a PDFs con C# permite a los equipos separar el diseño del PDF y el trabajo de renderizado del back-end. Este enfoque le permite convertir cualquier URL específica directamente al formato PDF.

CSS de Impresión vs Pantalla

Puede configurar IronPDF para renderizar usando cualquier tipo de medios CSS.

using IronPdf;
using IronPdf.Rendering;

// Initialize HTML to PDF converter
var renderer = new ChromePdfRenderer();

// Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Screen media type shows the entire web page as displayed on screen

using IronPdf;
using IronPdf.Rendering;

// Initialize HTML to PDF converter
var renderer = new ChromePdfRenderer();

// Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Screen media type shows the entire web page as displayed on screen

Imports IronPdf
Imports IronPdf.Rendering

' Initialize HTML to PDF converter
Dim renderer As New ChromePdfRenderer()

' Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print

' Screen media type shows the entire web page as displayed on screen

Soporte de JavaScript

IronPDF soporta completamente JavaScript, jQuery e incluso AJAX cuando convierte HTML a PDF. Para contenido HTML dinámico, puede configurar IronPDF para esperar la finalización del JavaScript antes de renderizar páginas web en PDF. Esto es perfecto para aplicaciones de una sola página y sitios web dinámicos.

using IronPdf;

// Configure JavaScript rendering for dynamic HTML content to PDF
var renderer = new ChromePdfRenderer();

// Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = true;

// WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

using IronPdf;

// Configure JavaScript rendering for dynamic HTML content to PDF
var renderer = new ChromePdfRenderer();

// Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = true;

// WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

Imports IronPdf

' Configure JavaScript rendering for dynamic HTML content to PDF
Dim renderer As New ChromePdfRenderer()

' Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = True

' WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500 ' milliseconds

La ejecución de JavaScript también se puede mostrar cuando se renderiza un gráfico de acordes d3.js avanzado desde una página web al formato PDF:

using IronPdf;

// Create renderer for JavaScript-heavy HTML
var renderer = new ChromePdfRenderer();

// Convert d3.js visualization web page to PDF
var pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006");

// Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf");

using IronPdf;

// Create renderer for JavaScript-heavy HTML
var renderer = new ChromePdfRenderer();

// Convert d3.js visualization web page to PDF
var pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006");

// Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf");

Imports IronPdf

' Create renderer for JavaScript-heavy HTML
Dim renderer As New ChromePdfRenderer()

' Convert d3.js visualization web page to PDF
Dim pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006")

' Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf")

CSS Responsivo

Como las páginas web responsivas están diseñadas para ser vistas en un navegador, y IronPDF no abre una ventana de navegador real en el sistema operativo de su servidor, los elementos HTML responsivos pueden renderizarse en su tamaño más pequeño. Se recomienda PdfCssMediaType.Print para navegar este problema al renderizar páginas web completas.

// Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

```vbnet
' Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
```

RELATED HOW-TO ARTICLE: How to Render URL to PDF

Cómo convertir un archivo HTML a PDF

Convertir archivos HTML locales a PDF preserva todos los recursos relativos incluyendo CSS, imágenes y JavaScript, como si se abrieran usando el protocolo file://. Este método de HTML a PDF es mejor para convertir plantillas o páginas HTML pre-diseñadas a documentos PDF.

using IronPdf;

// Initialize ChromePdfRenderer for HTML file conversion
var renderer = new ChromePdfRenderer();

// Convert HTML file to PDF documents
// Preserves all relative paths and linked resources in HTML
var pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html");

// Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf");

// All CSS, JavaScript, and images load correctly in the generated PDF

using IronPdf;

// Initialize ChromePdfRenderer for HTML file conversion
var renderer = new ChromePdfRenderer();

// Convert HTML file to PDF documents
// Preserves all relative paths and linked resources in HTML
var pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html");

// Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf");

// All CSS, JavaScript, and images load correctly in the generated PDF

Imports IronPdf

' Initialize ChromePdfRenderer for HTML file conversion
Dim renderer As New ChromePdfRenderer()

' Convert HTML file to PDF documents
' Preserves all relative paths and linked resources in HTML
Dim pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html")

' Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf")

' All CSS, JavaScript, and images load correctly in the generated PDF

RELATED HOW-TO Article: Render HTML File to PDF

Cómo convertir páginas Razor a PDF

Si tu proyecto ASP.NET Core ya utiliza páginas Razor, puedes convertirlas directamente a PDF sin reconstruir tu HTML. La extensión Razor de IronPDF agrega el método RenderRazorToPdf, que toma su página .cshtml, completa con su modelo y diseño, y la renderiza como un documento PDF en una sola llamada.

PM > Install-Paquete IronPdf.Extensions.Razor

PM > Install-Paquete IronPdf.Extensions.Razor

using IronPdf;

var renderer = new ChromePdfRenderer();

// Render a Razor Page directly to PDF
PdfDocument pdf = renderer.RenderRazorToPdf(this);

Response.Headers.Add("Content-Disposition", "inline");
return new FileContentResult(pdf.BinaryData, "application/pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Render a Razor Page directly to PDF
PdfDocument pdf = renderer.RenderRazorToPdf(this);

Response.Headers.Add("Content-Disposition", "inline");
return new FileContentResult(pdf.BinaryData, "application/pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Render a Razor Page directly to PDF
Dim pdf As PdfDocument = renderer.RenderRazorToPdf(Me)

Response.Headers.Add("Content-Disposition", "inline")
Return New FileContentResult(pdf.BinaryData, "application/pdf")

RELATED HOW-TO Article: How to Convert CSHTML to PDF in Razor Pages

Cómo convertir vistas MVC a PDF

Los equipos que usan el patrón MVC pueden generar PDFs directamente desde sus Vistas y controladores existentes. Instale el paquete de extensión de MVC Core, luego llame a RenderRazorViewToPdf con la ruta de su vista y modelo — IronPDF maneja el pipeline de renderizado Razor y produce un PDF terminado.

Esto es especialmente útil para informes, facturas y cualquier página donde el HTML ya esté diseñado y probado en el navegador. El PDF generado conserva la salida completa de la Vista, incluidas las páginas de diseño y vistas parciales.

PM > Install-Paquete IronPdf.Extensions.Mvc.Core

PM > Install-Paquete IronPdf.Extensions.Mvc.Core

Primero, registre el servicio IRazorViewRenderer en su Program.cs para que sus controladores puedan inyectarlo:

using IronPdf.Extensions.Mvc.Core;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

// Register the Razor view renderer for IronPDF
builder.Services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();
builder.Services.AddSingleton<IRazorViewRenderer, RazorViewRenderer>();

using IronPdf.Extensions.Mvc.Core;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

// Register the Razor view renderer for IronPDF
builder.Services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();
builder.Services.AddSingleton<IRazorViewRenderer, RazorViewRenderer>();

Imports IronPdf.Extensions.Mvc.Core

Dim builder = WebApplication.CreateBuilder(args)
builder.Services.AddControllersWithViews()

' Register the Razor view renderer for IronPDF
builder.Services.AddSingleton(Of IHttpContextAccessor, HttpContextAccessor)()
builder.Services.AddSingleton(Of IRazorViewRenderer, RazorViewRenderer)()

Luego en tu acción de controlador, inyecta el renderizador y convierte cualquier Vista a PDF:

using IronPdf;
using IronPdf.Extensions.Mvc.Core;

var renderer = new ChromePdfRenderer();

// Render an MVC View with model data to PDF
PdfDocument pdf = renderer.RenderRazorViewToPdf(
    _viewRenderService, "Views/Home/Report.cshtml", reportModel);

Response.Headers.Add("Content-Disposition", "inline");
return new FileContentResult(pdf.BinaryData, "application/pdf");

using IronPdf;
using IronPdf.Extensions.Mvc.Core;

var renderer = new ChromePdfRenderer();

// Render an MVC View with model data to PDF
PdfDocument pdf = renderer.RenderRazorViewToPdf(
    _viewRenderService, "Views/Home/Report.cshtml", reportModel);

Response.Headers.Add("Content-Disposition", "inline");
return new FileContentResult(pdf.BinaryData, "application/pdf");

Imports IronPdf
Imports IronPdf.Extensions.Mvc.Core

Dim renderer As New ChromePdfRenderer()

' Render an MVC View with model data to PDF
Dim pdf As PdfDocument = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Report.cshtml", reportModel)

Response.Headers.Add("Content-Disposition", "inline")
Return New FileContentResult(pdf.BinaryData, "application/pdf")

RELATED HOW-TO Article: How to Convert Views to PDF in ASP.NET Core MVC

Cómo configurar encabezados HTTP personalizados, cookies y credenciales de inicio de sesión

Al renderizar URLs que requieren autenticación o metadatos específicos de la solicitud, IronPDF te permite incluir credenciales de inicio de sesión, cookies de sesión y encabezados HTTP con la solicitud. Esto permite renderizar directamente a PDF los paneles de intranet, informes restringidos o páginas generadas por API sin la necesidad de recuperar el HTML por separado.

Para autenticación básica o NTLM, establezca un objeto LoginCredentials en el renderizador. Para el acceso basado en tokens o sesiones, pase cookies y encabezados a través de RenderingOptions antes de llamar a RenderUrlAsPdf.

using IronPdf;

var renderer = new ChromePdfRenderer();

// Network authentication (Basic, Digest, NTLM)
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword"
};

// Session cookies for authenticated pages
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123";

// Custom HTTP headers (e.g., Bearer tokens, API keys)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://intranet.company.com/quarterly-report");
pdf.SaveAs("quarterly-report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Network authentication (Basic, Digest, NTLM)
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword"
};

// Session cookies for authenticated pages
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123";

// Custom HTTP headers (e.g., Bearer tokens, API keys)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://intranet.company.com/quarterly-report");
pdf.SaveAs("quarterly-report.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Network authentication (Basic, Digest, NTLM)
renderer.LoginCredentials = New ChromeHttpLoginCredentials With {
    .NetworkUsername = "user@domain.com",
    .NetworkPassword = "securePassword"
}

' Session cookies for authenticated pages
renderer.RenderingOptions.CustomCookies("sessionId") = "abc123"

' Custom HTTP headers (e.g., Bearer tokens, API keys)
renderer.RenderingOptions.CustomHttpRequestHeaders("Authorization") = "Bearer eyJhbGciOi..."

Dim pdf = renderer.RenderUrlAsPdf("https://intranet.company.com/quarterly-report")
pdf.SaveAs("quarterly-report.pdf")

ARTÍCULOS RELACIONADOS: Render PDFs Behind Login Authentication | Custom HTTP Request Headers

Cómo configurar un proxy para el renderizado de PDF

Al renderizar HTML que carga recursos externos detrás de un proxy corporativo, pase la dirección del proxy como el tercer parámetro en RenderHtmlAsPdf(). Este es un parámetro de método, no una propiedad en ChromePdfRenderOptions — por lo tanto, se establece por llamada de renderizado, no en el renderizador.

Para proxies autenticados, incruste credenciales directamente en el URL usando el formato http://user:pass@host:port. Codifique en URL los caracteres especiales en contraseñas con Uri.EscapeDataString().

using IronPdf;

var renderer = new ChromePdfRenderer();

// Proxy is the third parameter — not a render option
PdfDocument pdf = renderer.RenderHtmlAsPdf(
    "<h1>Report</h1><link rel='stylesheet' href='https://cdn.example.com/styles.css'>",
    baseUrlOrPath: null,
    proxy: "http://proxy.corp.local:8080"
);
pdf.SaveAs("proxied-report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Proxy is the third parameter — not a render option
PdfDocument pdf = renderer.RenderHtmlAsPdf(
    "<h1>Report</h1><link rel='stylesheet' href='https://cdn.example.com/styles.css'>",
    baseUrlOrPath: null,
    proxy: "http://proxy.corp.local:8080"
);
pdf.SaveAs("proxied-report.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Proxy is the third parameter — not a render option
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(
    "<h1>Report</h1><link rel='stylesheet' href='https://cdn.example.com/styles.css'>",
    baseUrlOrPath:=Nothing,
    proxy:="http://proxy.corp.local:8080"
)
pdf.SaveAs("proxied-report.pdf")

Tenga en cuenta que RenderUrlAsPdf() no acepta un parámetro de proxy. Para renderizar un URL en vivo detrás de un proxy, obtenga el HTML primero con HttpClient configurado con un WebProxy, luego páselo a RenderHtmlAsPdf() con el parámetro de proxy para la carga de activos.

RELATED HOW-TO Article: How to Configure Proxy Servers for PDF Rendering

Cómo generar una plantilla HTML para la creación de PDF por lotes

Creación Básica de PDF en Lote

La creación de PDF en lote es esencial para generar múltiples documentos PDF personalizados de manera eficiente. Para escenarios básicos, el método String.Format en C# funciona mejor para la manipulación simple de PDF.

// Simple HTML templating with String.Format
string htmlTemplate = String.Format("<h1>Hello {0}!</h1>", "World");

// Results in HTML content: <h1>Hello World!</h1>

// Simple HTML templating with String.Format
string htmlTemplate = String.Format("<h1>Hello {0}!</h1>", "World");

// Results in HTML content: <h1>Hello World!</h1>

' Simple HTML templating with String.Format
Dim htmlTemplate As String = String.Format("<h1>Hello {0}!</h1>", "World")

' Results in HTML content: <h1>Hello World!</h1>

Para plantillas más largas cuando necesita generar documentos PDF, use la sustitución de marcadores de posición en su contenido HTML: using IronPDF;

// Define reusable HTML template for PDF files
var htmlTemplate = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>";

// Customer names for batch PDF conversion processing
var names = new[] { "John", "James", "Jenny" };

// Create personalized PDF documents for each customer
var renderer = new ChromePdfRenderer();

foreach (var name in names)
{
    // Replace placeholder with actual data in HTML string
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Generate personalized PDF document from HTML content
    var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf");
}

// Define reusable HTML template for PDF files
var htmlTemplate = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>";

// Customer names for batch PDF conversion processing
var names = new[] { "John", "James", "Jenny" };

// Create personalized PDF documents for each customer
var renderer = new ChromePdfRenderer();

foreach (var name in names)
{
    // Replace placeholder with actual data in HTML string
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Generate personalized PDF document from HTML content
    var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf");
}

' Define reusable HTML template for PDF files
Dim htmlTemplate As String = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>"

' Customer names for batch PDF conversion processing
Dim names As String() = {"John", "James", "Jenny"}

' Create personalized PDF documents for each customer
Dim renderer As New ChromePdfRenderer()

For Each name In names
    ' Replace placeholder with actual data in HTML string
    Dim htmlInstance As String = htmlTemplate.Replace("[[NAME]]", name)

    ' Generate personalized PDF document from HTML content
    Dim pdf = renderer.RenderHtmlAsPdf(htmlInstance)

    ' Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf")
Next

Plantillas de HTML a PDF con Handlebars.NET

Para plantillas complejas con bucles y condicionales al convertir HTML a PDF, use plantillas avanzadas con Handlebars.NET para generar documentos PDF con contenido HTML dinámico.

# First, install Handlebars.NET for HTML to PDF templating
PM > Install-Paquete Handlebars.NET

# First, install Handlebars.NET for HTML to PDF templating
PM > Install-Paquete Handlebars.NET

using HandlebarsDotNet;
using IronPdf;

// Define Handlebars template with placeholders for HTML content
var source = 
    @"<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>";

// Compile template for reuse in PDF conversion
var template = Handlebars.Compile(source);

// Create data object (can be database records) for HTML to PDF directly
var data = new { 
    title = "Monthly Report", 
    body = "Sales increased by 15% this month." 
};

// Merge template with data to create HTML content
var htmlResult = template(data);

// Convert templated HTML to PDF using the PDF converter
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlResult);

pdf.SaveAs("monthly-report.pdf");

using HandlebarsDotNet;
using IronPdf;

// Define Handlebars template with placeholders for HTML content
var source = 
    @"<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>";

// Compile template for reuse in PDF conversion
var template = Handlebars.Compile(source);

// Create data object (can be database records) for HTML to PDF directly
var data = new { 
    title = "Monthly Report", 
    body = "Sales increased by 15% this month." 
};

// Merge template with data to create HTML content
var htmlResult = template(data);

// Convert templated HTML to PDF using the PDF converter
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlResult);

pdf.SaveAs("monthly-report.pdf");

Imports HandlebarsDotNet
Imports IronPdf

' Define Handlebars template with placeholders for HTML content
Dim source As String = 
    "<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>"

' Compile template for reuse in PDF conversion
Dim template = Handlebars.Compile(source)

' Create data object (can be database records) for HTML to PDF directly
Dim data = New With { 
    .title = "Monthly Report", 
    .body = "Sales increased by 15% this month." 
}

' Merge template with data to create HTML content
Dim htmlResult = template(data)

' Convert templated HTML to PDF using the PDF converter
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlResult)

pdf.SaveAs("monthly-report.pdf")

RELATED HOW-TO Article: Learn more about Handlebars.NET on GitHub

<!DOCTYPE html>
<html>
  <head>
    <style type="text/css" media="print">
      .page {
        page-break-after: always;
        page-break-inside: avoid;
      }
    </style>
  </head>
  <body>
    <div class="page">
      <h1>Page 1 Content</h1>
    </div>
    <div class="page">
      <h1>Page 2 Content</h1>
    </div>
    <div class="page">
      <h1>Page 3 Content</h1>
    </div>
  </body>
</html>

<!DOCTYPE html>
<html>
  <head>
    <style type="text/css" media="print">
      .page {
        page-break-after: always;
        page-break-inside: avoid;
      }
    </style>
  </head>
  <body>
    <div class="page">
      <h1>Page 1 Content</h1>
    </div>
    <div class="page">
      <h1>Page 2 Content</h1>
    </div>
    <div class="page">
      <h1>Page 3 Content</h1>
    </div>
  </body>
</html>

Cómo generar un PDF mediante el método asíncrono

IronPDF ofrece rendimiento a nivel empresarial con soporte completo para async y multihilos para sus requisitos de conversión de HTML a PDF cuando necesita generar archivos PDF a gran escala.

using IronPdf;
using System.Threading.Tasks;

// Async method for non-blocking PDF generation from HTML content
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();

    // Async HTML to PDF conversion preserves thread pool
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);

    // Return PDF files as byte array for web responses
    return pdf.BinaryData;
}

// Concurrent batch PDF generation for multiple HTML strings
public async Task GenerateMultiplePdfsAsync(List<string> htmlPlantillas)
{
    var renderer = new ChromePdfRenderer();

    // Create parallel conversion tasks to generate PDF documents
    var tasks = htmlPlantillas.Select(html => 
        renderer.RenderHtmlAsPdfAsync(html)
    );

    // Await all PDF conversions simultaneously
    var pdfs = await Task.WhenAll(tasks);

    // Save generated PDF files from HTML content
    for (int i = 0; i < pdfs.Length; i++)
    {
        pdfs[i].SaveAs($"document-{i}.pdf");
    }
}

using IronPdf;
using System.Threading.Tasks;

// Async method for non-blocking PDF generation from HTML content
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();

    // Async HTML to PDF conversion preserves thread pool
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);

    // Return PDF files as byte array for web responses
    return pdf.BinaryData;
}

// Concurrent batch PDF generation for multiple HTML strings
public async Task GenerateMultiplePdfsAsync(List<string> htmlPlantillas)
{
    var renderer = new ChromePdfRenderer();

    // Create parallel conversion tasks to generate PDF documents
    var tasks = htmlPlantillas.Select(html => 
        renderer.RenderHtmlAsPdfAsync(html)
    );

    // Await all PDF conversions simultaneously
    var pdfs = await Task.WhenAll(tasks);

    // Save generated PDF files from HTML content
    for (int i = 0; i < pdfs.Length; i++)
    {
        pdfs[i].SaveAs($"document-{i}.pdf");
    }
}

Imports IronPdf
Imports System.Threading.Tasks

' Async method for non-blocking PDF generation from HTML content
Public Async Function GeneratePdfAsync(html As String) As Task(Of Byte())
    Dim renderer As New ChromePdfRenderer()

    ' Async HTML to PDF conversion preserves thread pool
    Dim pdf = Await renderer.RenderHtmlAsPdfAsync(html)

    ' Return PDF files as byte array for web responses
    Return pdf.BinaryData
End Function

' Concurrent batch PDF generation for multiple HTML strings
Public Async Function GenerateMultiplePdfsAsync(htmlPlantillas As List(Of String)) As Task
    Dim renderer As New ChromePdfRenderer()

    ' Create parallel conversion tasks to generate PDF documents
    Dim tasks = htmlPlantillas.Select(Function(html) renderer.RenderHtmlAsPdfAsync(html))

    ' Await all PDF conversions simultaneously
    Dim pdfs = Await Task.WhenAll(tasks)

    ' Save generated PDF files from HTML content
    For i As Integer = 0 To pdfs.Length - 1
        pdfs(i).SaveAs($"document-{i}.pdf")
    Next
End Function

• Use sistemas de 64 bits para un rendimiento óptimo de generación de PDF.
• Asegúrese de contar con recursos de servidor adecuados cuando genere documentos PDF (evite niveles gratuitos con poca capacidad)
• Permita RenderDelay suficiente for JavaScript complejo en contenido HTML.
• Reutilice instancias ChromePdfRenderer cuando sea posible.
• Aproveche correcciones de memoria de v2025.9.4 para operaciones por lotes/async y reducir recursos. pruebe con tamaños de archivo reducidos con encabezados/pies de página personalizados repetidos.

RELATED HOW-TO Article: How to Generate PDFs with Async and Multithreading

Cómo agregar funciones de seguridad avanzadas

Cómo Agregar Protección por Contraseña para Archivos PDF en .NET

Proteja documentos PDF generados sensibles con contraseñas y permisos cuando convierta contenido HTML a un formato PDF protegido.

using IronPdf;
var renderer = new ChromePdfRenderer();

// Convert HTML to PDF with security
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>");

// Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123";     // Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456";   // Password to modify PDF files

// Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserAnnotations = false;
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint;

// Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256;
pdf.SaveAs("secure-document.pdf");

using IronPdf;
var renderer = new ChromePdfRenderer();

// Convert HTML to PDF with security
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>");

// Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123";     // Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456";   // Password to modify PDF files

// Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserAnnotations = false;
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint;

// Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256;
pdf.SaveAs("secure-document.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Convert HTML to PDF with security
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>")

' Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123"     ' Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456"   ' Password to modify PDF files

' Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserAnnotations = False
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint

' Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256
pdf.SaveAs("secure-document.pdf")

Cómo Agregar Firmas Digitales a Archivos PDF

Agregue firmas criptográficas para asegurar la autenticidad del documento PDF cuando genere archivos PDF a partir de contenido HTML.

using IronPdf;
using IronPdf.Signing;

var renderer = new ChromePdfRenderer();

// Generate PDF from HTML page
var pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>");

// Create digital signature with certificate for PDF files
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "legal@company.com",
    SigningLocation = "New York, NY",
    SigningReason = "Contract Approval",
    SignerName = "Authorized Signer"  // New property in v2025.8.8 for enhanced signature details
};

// Apply signature to PDF documents
pdf.Sign(signature);
pdf.SaveAs("signed-contract.pdf");

using IronPdf;
using IronPdf.Signing;

var renderer = new ChromePdfRenderer();

// Generate PDF from HTML page
var pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>");

// Create digital signature with certificate for PDF files
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "legal@company.com",
    SigningLocation = "New York, NY",
    SigningReason = "Contract Approval",
    SignerName = "Authorized Signer"  // New property in v2025.8.8 for enhanced signature details
};

// Apply signature to PDF documents
pdf.Sign(signature);
pdf.SaveAs("signed-contract.pdf");

Imports IronPdf
Imports IronPdf.Signing

Dim renderer As New ChromePdfRenderer()

' Generate PDF from HTML page
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>")

' Create digital signature with certificate for PDF files
Dim signature As New PdfSignature("certificate.pfx", "password") With {
    .SigningContact = "legal@company.com",
    .SigningLocation = "New York, NY",
    .SigningReason = "Contract Approval",
    .SignerName = "Authorized Signer"  ' New property in v2025.8.8 for enhanced signature details
}

' Apply signature to PDF documents
pdf.Sign(signature)
pdf.SaveAs("signed-contract.pdf")

RELATED HOW-TO Article: Digitally Signing PDF Documents with C#

Cómo convertir formularios HTML a PDFs rellenable

Para convertir elementos de formulario HTML estándar en campos de formulario PDF interactivos y rellenables, active la opción de renderizado CreatePdfFormsFromHtml. Esto conserva entradas de texto, casillas, botones de opción y menús desplegables como campos editables en el documento PDF generado.

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable HTML form to PDF form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string htmlForm = @"
    <h2>Employee Onboarding Form</h2>
    <form>
        <label>Full Name:</label>
        <input type='text' name='fullName' value='' /><br/>
        <label>Department:</label>
        <select name='department'>
            <option value='engineering'>Engineering</option>
            <option value='marketing'>Marketing</option>
            <option value='sales'>Sales</option>
        </select><br/>
        <label>Agree to Terms:</label>
        <input type='checkbox' name='agreeTerms' />
    </form>";

var pdf = renderer.RenderHtmlAsPdf(htmlForm);
pdf.SaveAs("onboarding-form.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable HTML form to PDF form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string htmlForm = @"
    <h2>Employee Onboarding Form</h2>
    <form>
        <label>Full Name:</label>
        <input type='text' name='fullName' value='' /><br/>
        <label>Department:</label>
        <select name='department'>
            <option value='engineering'>Engineering</option>
            <option value='marketing'>Marketing</option>
            <option value='sales'>Sales</option>
        </select><br/>
        <label>Agree to Terms:</label>
        <input type='checkbox' name='agreeTerms' />
    </form>";

var pdf = renderer.RenderHtmlAsPdf(htmlForm);
pdf.SaveAs("onboarding-form.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Enable HTML form to PDF form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = True

Dim htmlForm As String = "
    <h2>Employee Onboarding Form</h2>
    <form>
        <label>Full Name:</label>
        <input type='text' name='fullName' value='' /><br/>
        <label>Department:</label>
        <select name='department'>
            <option value='engineering'>Engineering</option>
            <option value='marketing'>Marketing</option>
            <option value='sales'>Sales</option>
        </select><br/>
        <label>Agree to Terms:</label>
        <input type='checkbox' name='agreeTerms' />
    </form>"

Dim pdf = renderer.RenderHtmlAsPdf(htmlForm)
pdf.SaveAs("onboarding-form.pdf")

RELATED HOW-TO Article: How to Create Fillable PDF Forms in C#

Cómo convertir elementos HTML específicos a PDF

Para renderizar una sección específica de una página en lugar del documento completo, aísle el elemento objetivo antes de renderizar. La forma más directa utiliza la opción de renderizado JavaScript para reemplazar el cuerpo del documento con el contenido del elemento objetivo, combinado con WaitFor.HtmlQuerySelector() para asegurar que el elemento exista antes de la extracción. El fragmento a continuación preserva document.head para que las hojas de estilo y fuentes se mantengan — sin ese paso, las reglas CSS que dependen de selectores de ancestros se perderían en el PDF extraído.

Para escenarios del lado del servidor donde tiene acceso al HTML sin procesar, extraiga el fragmento objetivo con un analizador como AngleSharp y páselo a RenderHtmlAsPdf() — no es necesario ejecutar JavaScript.

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;

// Replace the body with only the target element
renderer.RenderingOptions.JavaScript = @"
    var el = document.querySelector('#invoice-summary');
    if (el) {
        var head = document.head.innerHTML;
        document.body.innerHTML = el.outerHTML;
        document.head.innerHTML = head;
    }
";

// Wait for the target element before JS executes
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("#invoice-summary", 10000);

var pdf = renderer.RenderHtmlAsPdf(fullPageHtml);
pdf.SaveAs("invoice-summary.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;

// Replace the body with only the target element
renderer.RenderingOptions.JavaScript = @"
    var el = document.querySelector('#invoice-summary');
    if (el) {
        var head = document.head.innerHTML;
        document.body.innerHTML = el.outerHTML;
        document.head.innerHTML = head;
    }
";

// Wait for the target element before JS executes
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("#invoice-summary", 10000);

var pdf = renderer.RenderHtmlAsPdf(fullPageHtml);
pdf.SaveAs("invoice-summary.pdf");

Imports IronPdf

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True

' Replace the body with only the target element
renderer.RenderingOptions.JavaScript = "
    var el = document.querySelector('#invoice-summary');
    if (el) {
        var head = document.head.innerHTML;
        document.body.innerHTML = el.outerHTML;
        document.head.innerHTML = head;
    }
"

' Wait for the target element before JS executes
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("#invoice-summary", 10000)

Dim pdf = renderer.RenderHtmlAsPdf(fullPageHtml)
pdf.SaveAs("invoice-summary.pdf")

RELATED HOW-TO Article: How to Convert HTML Elements and Partial Pages to PDF

Cómo renderizar páginas autenticadas a PDF

Hay tres mecanismos para renderizar páginas que están detrás de la autenticación: credenciales de inicio de sesión de red, cookies personalizadas y encabezados de solicitudes HTTP. Estos cubren los escenarios de autenticación más comunes al convertir contenido web protegido a PDF.

Credenciales de inicio de sesión

Use ChromeHttpLoginCredentials para autenticación básica, de resumen (digest) o NTLM al convertir URLs protegidos a PDF.

using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure network authentication
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword",
    AuthenticationType = ChromeHttpLoginCredentials.AuthType.Basic
};

var pdf = renderer.RenderUrlAsPdf("https://intranet.company.com/reports");
pdf.SaveAs("authenticated-report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure network authentication
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword",
    AuthenticationType = ChromeHttpLoginCredentials.AuthType.Basic
};

var pdf = renderer.RenderUrlAsPdf("https://intranet.company.com/reports");
pdf.SaveAs("authenticated-report.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Configure network authentication
renderer.LoginCredentials = New ChromeHttpLoginCredentials With {
    .NetworkUsername = "user@domain.com",
    .NetworkPassword = "securePassword",
    .AuthenticationType = ChromeHttpLoginCredentials.AuthType.Basic
}

Dim pdf = renderer.RenderUrlAsPdf("https://intranet.company.com/reports")
pdf.SaveAs("authenticated-report.pdf")

Cookies y encabezados HTTP

Para la autenticación basada en token o sesión, adjunte cookies personalizadas y encabezados HTTP directamente a la solicitud de renderizado.

using IronPdf;

var renderer = new ChromePdfRenderer();

// Add session cookies
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123token";
renderer.RenderingOptions.CustomCookies["authToken"] = "bearer-xyz";

// Add custom HTTP headers (e.g., API key or Bearer token)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://app.example.com/dashboard");
pdf.SaveAs("dashboard.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Add session cookies
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123token";
renderer.RenderingOptions.CustomCookies["authToken"] = "bearer-xyz";

// Add custom HTTP headers (e.g., API key or Bearer token)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://app.example.com/dashboard");
pdf.SaveAs("dashboard.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Add session cookies
renderer.RenderingOptions.CustomCookies("sessionId") = "abc123token"
renderer.RenderingOptions.CustomCookies("authToken") = "bearer-xyz"

' Add custom HTTP headers (e.g., API key or Bearer token)
renderer.RenderingOptions.CustomHttpRequestHeaders("Authorization") = "Bearer eyJhbGciOi..."

Dim pdf = renderer.RenderUrlAsPdf("https://app.example.com/dashboard")
pdf.SaveAs("dashboard.pdf")

RELATED HOW-TO Article: How to Convert HTML Behind Login Authentication to PDF

Cómo implementar en Azure

Al implementar en Azure Functions o App Service, deshabilite la aceleración de GPU y asegúrese de que su nivel de alojamiento proporcione suficiente memoria para el renderizado basado en Chrome. Agregue estas configuraciones al inicio de la aplicación, antes de cualquier llamada de renderizado.

Los sandboxes de Azure se ejecutan sin cabeza sin acceso a GPU, y los niveles gratuitos/compartidos (F1, D1) carecen de los recursos necesarios para Chrome. Apunte a un nivel B1 (Básico) o superior.

using IronPdf;

// Azure sandboxes block GPU access — always disable
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
// Required on non-GUI Linux systems
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Azure PDF Report</h1>");
pdf.SaveAs("azure-report.pdf");

using IronPdf;

// Azure sandboxes block GPU access — always disable
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
// Required on non-GUI Linux systems
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Azure PDF Report</h1>");
pdf.SaveAs("azure-report.pdf");

Imports IronPdf

' Azure sandboxes block GPU access — always disable
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
' Required on non-GUI Linux systems
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Azure PDF Report</h1>")
pdf.SaveAs("azure-report.pdf")

RELATED GET-STARTED Guide: How to Deploy IronPDF on Azure

Cómo implementar en AWS Lambda

AWS Lambda requiere una implementación basada en Docker para el renderizado PDF basado en Chrome. El sistema de archivos predeterminado de Lambda es de solo lectura, por lo que todos los caminos temporales y de despliegue deben apuntar a /tmp.

Configure estas configuraciones en la parte superior de su manejador de funciones, antes de cualquier llamada de renderizado.

using Amazon.Lambda.Core;
using IronPdf;

public class PdfFunction
{
    public string FunctionHandler(string input, ILambdaContext context)
    {
        // Lambda's only writable directory
        var tmpPath = "/tmp/";

        IronPdf.Installation.TempFolderPath = tmpPath;
        IronPdf.Installation.CustomDeploymentDirectory = tmpPath;
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
        // Let IronPDF install Chrome dependencies on first cold start
        IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

        context.Logger.LogLine("Rendering PDF...");

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

        // Save to /tmp before uploading to S3 or returning
        var outputPath = $"{tmpPath}output.pdf";
        pdf.SaveAs(outputPath);

        return outputPath;
    }
}

using Amazon.Lambda.Core;
using IronPdf;

public class PdfFunction
{
    public string FunctionHandler(string input, ILambdaContext context)
    {
        // Lambda's only writable directory
        var tmpPath = "/tmp/";

        IronPdf.Installation.TempFolderPath = tmpPath;
        IronPdf.Installation.CustomDeploymentDirectory = tmpPath;
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
        // Let IronPDF install Chrome dependencies on first cold start
        IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

        context.Logger.LogLine("Rendering PDF...");

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

        // Save to /tmp before uploading to S3 or returning
        var outputPath = $"{tmpPath}output.pdf";
        pdf.SaveAs(outputPath);

        return outputPath;
    }
}

Imports Amazon.Lambda.Core
Imports IronPdf

Public Class PdfFunction
    Public Function FunctionHandler(input As String, context As ILambdaContext) As String
        ' Lambda's only writable directory
        Dim tmpPath As String = "/tmp/"

        IronPdf.Installation.TempFolderPath = tmpPath
        IronPdf.Installation.CustomDeploymentDirectory = tmpPath
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
        ' Let IronPDF install Chrome dependencies on first cold start
        IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

        context.Logger.LogLine("Rendering PDF...")

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

        ' Save to /tmp before uploading to S3 or returning
        Dim outputPath As String = $"{tmpPath}output.pdf"
        pdf.SaveAs(outputPath)

        Return outputPath
    End Function
End Class

RELATED GET-STARTED Guide: How to Deploy IronPDF on AWS Lambda

Cómo implementar con Docker

Para despliegues en Docker, use el paquete de NuGet IronPdf.Linux para reducir el tamaño de la imagen y evitar descargas de activos en tiempo de ejecución. Este paquete incluye binarios nativos de Linux preempaquetados optimizados para entornos de contenedores.

Establezca LinuxAndDockerDependenciesAutoConfig = false cuando su Dockerfile ya instale las dependencias de bibliotecas compartidas de Chrome a través de apt-get. La auto-instalación en tiempo de ejecución es redundante en ese caso y puede causar errores de permisos o inicios en frío más largos.

Un Dockerfile mínimo multi-etapa para una imagen basada en Ubuntu/Debian:

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app
COPY . .
RUN dotnet publish -c Release -o /out

FROM mcr.microsoft.com/dotnet/aspnet:8.0
# Install Chrome dependencies for PDF rendering
RUN apt-get update && apt-get install -y \
    libglib2.0-0 libnss3 libatk1.0-0 libatk-bridge2.0-0 \
    libcups2 libdrm2 libxkbcommon0 libxcomposite1 \
    libxdamage1 libxrandr2 libgbm1 libpango-1.0-0 \
    libcairo2 libasound2 libxshmfence1 && \
    rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /out .
ENTRYPOINT ["dotnet", "MyApp.dll"]

using IronPdf;

// Dependencies handled by Dockerfile apt-get — disable runtime install
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
// No GPU in containers
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Dockerized PDF</h1>");
pdf.SaveAs("output.pdf");

using IronPdf;

// Dependencies handled by Dockerfile apt-get — disable runtime install
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
// No GPU in containers
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Dockerized PDF</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf

' Dependencies handled by Dockerfile apt-get — disable runtime install
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False
' No GPU in containers
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Dockerized PDF</h1>")
pdf.SaveAs("output.pdf")

RELATED GET-STARTED Guide: How to Use IronPDF with Docker

Matriz de decisión rápida: IronPDF frente a otros convertidores de PDF .NET

COMPARACIONES RELACIONADAS:

• Comparar IronPDF y Syncfusion
• Comparar IronPDF y Aspose

Comparación detallada: IronPDF frente a otros convertidores de PDF .NET

Comparación de conversión de HTML a PDF en la vida real: Representación de la página de inicio de Reddit

Para evaluar la calidad del PDF de salida, probamos estas bibliotecas con la página principal de Reddit que contiene contenido web dinámico, CSS moderno y elementos HTML de JavaScript. Esta página sirve como un caso de prueba ideal para la generación de PDF de salida.

https://www.reddit.com/

IronPDF

IronPDF ofrece resultados pixel-perfect, preservando todo el contenido web dinámico, el estilo de fuentes web modernas y los elementos interactivos exactamente como se muestran en Chrome, todo en tan solo unas pocas líneas de código.

Syncfusion

Syncfusion renderizó el PDF con la mayoría de las secciones y estilos ausentes, especialmente el contenido dinámico. Inicialmente bloqueado por la seguridad de Reddit. Lograr mejores resultados requiere una extensa configuración de línea de comandos, pero la salida sigue siendo incompleta.

Aspose.PDF

Aspose.PDF requirió primero una descarga manual de HTML (sin soporte para URL directo). Después de la conversión, el resultado carecía de un formato adecuado y se perdieron casi todas las secciones de contenido, lo que lo hace inadecuado para la web moderna con contenido dinámico.

wkhtmltopdf

wkhtmltopdf se completó rápidamente, pero produjo una página plana y estática que carece de contenido crítico como actualizaciones en vivo, elementos dinámicos y secciones interactivas. Esto demuestra la incompatibilidad de wkhtmltopdf con sitios web modernos impulsados por JavaScript.

Conclusión sobre el rendimiento y la calidad del PDF de salida

Para los desarrolladores .NET que necesitan un conversor confiable de HTML a PDF, IronPDF se destaca con un código mínimo, APIs fáciles de usar y mejoras frecuentes del producto.

En una prueba del mundo real en contenido web, ofreció los resultados más rápidos y precisos, mientras que Syncfusion quedó rezagado, Aspose requirió pasos adicionales y wkhtmltopdf careció de estilo moderno. IronPDF ofrece el mejor equilibrio de velocidad, precisión y simplicidad para los flujos de trabajo de conversión de HTML a PDF de hoy.

Por favor note: Aspose, Syncfusion y wkhtmltopdf son marcas registradas de sus respectivos propietarios. Este sitio no está afiliado ni es patrocinado por ellos. Todos los nombres, logotipos y marcas pertenecen a sus propietarios, y las comparaciones se basan en la información públicamente disponible al momento de escribir.

Resumen

Esta guía cubrió todo lo necesario para convertir HTML a PDF en .NET: desde la conversión básica de cadenas hasta funciones avanzadas como procesamiento asíncrono, firmas digitales y generación de lotes. Demostramos tres métodos de conversión, configuraciones esenciales, funciones avanzadas y configuraciones de seguridad, y comparamos IronPDF con otras bibliotecas mediante pruebas del mundo real de generación de documentos dinámicos.

Mientras los competidores lucharon con sitios web modernos o requerían soluciones complejas, IronPDF ofreció resultados impecables con un código mínimo y un potente motor de renderización.

¿Listo para simplificar tu flujo de trabajo de PDF y experimentar una generación versátil de PDF en solo unas pocas líneas de código? Instala IronPDF a través del Administrador de Paquetes NuGet (o selecciona Administrar Paquetes NuGet en Visual Studio) y convierte tu primer HTML a PDF hoy.

Comienza tu prueba gratuita de 30 días para realizar pruebas de producción sin marcas de agua. Licencias flexibles comienzan en $999 con precios de equipo transparentes que escalan con tus necesidades.

Ver licencias de IronPDF

Pipeline HTML → PDF para facturas VeriFactu

El sistema VeriFactu (anti-fraude de software de facturación, regulado por la AEAT) requiere que el software de facturación genere PDFs de facturas a partir de sus registros XML con huella encadenada. El pipeline recomendado con IronPDF es:

1. El motor de facturación del ISV genera el XML VeriFactu con la huella (hash SHA-256 encadenado).
2. Una plantilla HTML (Handlebars, Razor o XSLT → HTML) renderiza los datos de la factura.
3. ChromePdfRenderer.RenderHtmlAsPdf() genera el PDF.
4. TextStamper estampa la leyenda obligatoria *VERIFACTU** (con asterisco entre "VERI" y "FACTU").
5. ImageStamper incrusta el código QR de verificación de la sede electrónica de la AEAT.

Nota para ISVs: El incumplimiento de VeriFactu puede acarrear sanciones de hasta 150.000 €/año para los proveedores de software de facturación. IronPDF actúa como componente dentro del software certificado del ISV; la certificación ante la AEAT es responsabilidad del proveedor.

Ventaja sobre iText AGPL en el contexto VeriFactu

En España, el uso de iText bajo licencia AGPL en software de facturación sujeto a VeriFactu expone al ISV a un riesgo triple: (1) la obligación de publicar el código fuente bajo AGPL, (2) el coste de la licencia comercial de iText si no se publica el código, y (3) la sanción VeriFactu de hasta 150.000 €/año si el software no cumple la normativa. IronPDF, bajo licencia comercial propietaria, elimina la exposición AGPL manteniendo la conformidad con VeriFactu.

Plantillas HTML para documentos AEAT: declaraciones y modelos fiscales

Los desarrolladores que generan PDFs de declaraciones fiscales de la AEAT (Modelo 303, Modelo 111, Modelo 190, Modelo 347) a partir de plantillas HTML pueden usar IronPDF para renderizar los formularios HTML con datos dinámicos. Configure RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print para obtener el diseño de impresión correcto y PaperSize = A4 para el formato A4 exigido por la AEAT.

TicketBAI: representación PDF del tique por territorio foral

Los tiques TicketBAI para Bizkaia, Gipuzkoa y Araba se representan como PDF a partir de plantillas HTML específicas de cada hacienda foral. Si el entorno de generación es AWS Lambda (Linux), instale las fuentes para caracteres castellanos y euskera en el contenedor Docker (ver fuentes rotas en AWS Lambda). Configure InputEncoding = "UTF-8" para garantizar la correcta representación de los caracteres acentuados del castellano y del euskera en el PDF del tique.

LOPDGDD y generación de PDFs con datos personales

Al generar PDFs desde HTML que contienen datos personales (facturas con NIF/CIF del destinatario, contratos, nóminas), la LOPDGDD exige que el procesamiento sea seguro. Configure protección por contraseña con AES-256 usando SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256 sobre los PDFs que contengan datos personales antes de almacenarlos o transmitirlos, cumpliendo los requisitos de la AEPD.

Soluciones rápidas a errores comunes

• ¿Lenta primera renderización? Normal. Chrome se inicializa en 2–3s, luego acelera.
• ¿Problemas en la nube? Usa al menos Azure B1 o recursos equivalentes.
• ¿Recursos faltantes? Configura rutas base o incrusta como base64.
• ¿Elementos faltantes? Añade RenderDelay para ejecución de JavaScript.
• ¿Memoria en renderización? Actualiza a v2025.9.4 para correcciones en HTML a PDF, sellos y encabezados/pies.
• ¿Problemas con campos de formulario (p.ej., áreas de texto largas, casillas de verificación)? Corregido en v2025.7.17; asegúrate de nombres únicos para casillas de verificación.
• ¿Recorte de encabezado/pie personalizado o caracteres especiales corruptos? Resuelto en v2025.8.8; prueba el ajuste de palabras y metadatos.

Obtenga ayuda de los ingenieros que construyeron IronPDF, 24/7

• Guía completa de solución de problemas
• Estrategias de optimización del rendimiento
• Solicitudes de soporte de ingeniería
• Lista de verificación rápida para la resolución de problemas

Próximos pasos