IRONSOFTWAREHOME

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

Jacob Mellor, Director de Tecnología @ Team Iron
Jacob Mellor
Updated: 5 de septiembre de 2026

La conversión de HTML a PDF en C# suele parecer sencilla hasta que aparecen los requisitos del mundo real. Los desarrolladores encuentran rápidamente limitaciones que afectan a la precisión de la representación, la implementación y la escalabilidad.

Más allá de la renderización, la compatibilidad con la infraestructura se convierte en un aspecto crítico. Los equipos deben asegurarse de que la generación de PDF funcione en tiempos de ejecución .NET modernos, plataformas en la nube y entornos en contenedores sin merma del rendimiento.

Para subsanar estas deficiencias, las soluciones modernas basadas en Chrome, como IronPDF, ofrecen una mayor fidelidad de representación, una compatibilidad más amplia con plataformas y flujos de trabajo de implementación listos para la producción, que se exploran paso a paso en el resto de esta guía.

TL;DR: Guía de inicio rápido para convertir HTML a PDF

Puede convertir fácilmente HTML a PDF en C# usando la IronPDF biblioteca, que proporciona el método ChromePdfRenderer.RenderHtmlAsPdf para crear archivos PDF de alta calidad desde HTML, CSS y JavaScript.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Copie y ejecute este fragmento de código.

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
    C#
  3. 3Despliegue para probar en su entorno real

    Comienza a usar IronPDF en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

Después de haber comprado o inscrito en una prueba de 30 días de IronPDF, busque la clave de licencia enviada a su correo electrónico. Establece la propiedad TempFolderPath de IronPdf.Installation.

IronPdf.License.LicenseKey = "KEY";
¿Por qué los desarrolladores de .NET necesitan un convertidor de HTML a PDF para C#?

IronPDF aprovecha un motor de renderizado Google Chromium incorporado para asegurar conversiones de alta fidelidad, preservando con precisión el diseño y estilo de su contenido web.

Motor de Renderizado de Chrome Robusto: El motor Blink de Chrome para una conversión precisa de HTML a PDF, ahora mejorado con correcciones para memoria, formularios y precisión de renderizado (v2025.9.4)

Precisión de Pixel-Perfect: Los PDFs generados coinciden exactamente con la web, no una versión optimizada para impresión. Las correcciones recientes cubren recorte de encabezados y pies de página personalizados, preservación de texto en escala de grises y caracteres especiales/emojis en metadatos (a partir de v2025.9.4)

Soporte Completo para la Web Moderna: Soporte completo para CSS3, HTML5, JavaScript para todos los elementos HTML. Las mejoras recientes cubren el manejo de campos de formulario para áreas de texto largas y casillas de verificación.

Aumento de Rendimiento de 5-20 Veces: Mucho más rápido que la automatización del navegador o los controladores web, ahora con correcciones de fugas de memoria y reducciones de tamaños de archivo para elementos repetidos como sellos/encabezados en operaciones por lotes.

Cumplimiento de PDF/UA: Generación de PDFs accesibles que cumplen con los estándares de la Sección 508, mejorado para renderización de formularios multiplataforma (por ejemplo, Linux).

Sin Dependencias Externas: No hay ejecutables para instalar en los servidores

✅ Diseñado para C#, F# y VB.NET ejecutándose en .NET 10, 9, 8, 7, 6, Core, Standard, o Framework

IronPDF simplifica el proceso para desarrolladores .NET, ofreciendo una solución sencilla y eficiente para generar documentos PDF de aspecto profesional desde el HTML de su aplicación web. Desde facturas e informes hasta certificados y archivos, los desarrolladores pueden trabajar con su stack web familiar mientras IronPDF maneja lo complejo en solo unas líneas de código.

RELATED: IronPDF Changelog: Updates, milestones, roadmap

Lo que aprenderás
  1. Cómo convertir HTML a PDF C#

  1. Cómo configurar los ajustes de HTML a PDF
  1. Cómo utilizar las funciones avanzadas de generación y seguridad de PDF

  1. Cómo desplegar HTML a PDF en plataformas en la nube
  1. Comparar IronPDF con otras bibliotecas PDF de .NET

  2. Solución de problemas y soporte técnico

1. How to Convert HTML to PDF C#

Ya sea que trabaje con cadenas HTML, URLs o archivos HTML, IronPDF proporciona opciones flexibles para generar documentos PDF de alta calidad que cumplen con sus requisitos específicos.

En este tutorial, lo guiaremos por los escenarios más comunes, incluyendo cadena HTML a PDF, URL a PDF y archivo HTML a PDF. Además, IronPDF también proporciona una variedad de operaciones para manipular documentos PDF:

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");
Consejos: (Actualizado para v2025.9.4) Las actualizaciones recientes solucionan problemas con caracteres especiales/emojis en metadatos HTML y aseguran un mejor manejo de campos de formulario HTML, incluyendo caracteres chinos en Linux. Pruebe contenido dinámico con EnableJavaScript = true para obtener resultados óptimos.

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");
Consejos: BaseUrlPath le dice a IronPDF dónde encontrar sus archivos CSS, JavaScript e imágenes. Todas las rutas relativas en su cadena HTML se resolverán desde este directorio.

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

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

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");

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;

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
Consejos: Mantenga sus archivos HTML en una carpeta separada con sus activos (CSS, imágenes) para editar y probar en un navegador antes de convertir el archivo HTML a PDF. Esto asegura que su HTML se renderiza perfectamente para documentos PDF de alta calidad.

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
SHELL
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");
Por favor nota: RenderRazorToPdf requiere un proyecto de aplicación web ASP.NET Core. No funcionará en aplicaciones de consola o bibliotecas de clases — el motor de vista Razor debe estar disponible en el pipeline de alojamiento.

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
SHELL

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>();

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");

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

Página web dinámica a PDF

¿Necesitas que tu página web dinámica se conserve y convierta a PDFs mientras se preserva el diseño y formato exacto? No busques más allá de IronPDF, que convierte rápidamente una variedad de populares frameworks de páginas web dinámicas a PDFs.

PDF a partir de páginas ASPX

Aquí hay un breve fragmento de código sobre la conversión de Páginas ASPX como PDF en Páginas de Servidor Activo.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using IronPdf;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);
        }
    }
}

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

XAML a PDF (MAUI)

Para los desarrolladores que buscan construir aplicaciones multiplataforma, .NET MAUI es una elección popular entre los frameworks. IronPDF soporta por completo la conversión de XAML a PDF con unos pocos pasos.

using IronPdf.Extensions.Maui;

namespace mauiSample;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private void PrintToPdf(object sender, EventArgs e)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Apply HTML header
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<h1>Header</h1>",
        };

        // Render PDF from Maui Page
        PdfDocument pdf = renderer.RenderContentPageToPdf<MainPage, App>().Result;

        pdf.SaveAs(@"C:\Users\lyty1\Downloads\contentPageToPdf.pdf");
    }
}

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

Generar informes en PDF

Cuando se trata de generar Reportes PDF, las dimensiones y formato exactos son cruciales. Como tal, IronPDF te permite generar PDFs sin problemas con solo un par de pasos.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderHtmlFileAsPdf("report.html").SaveAs("report.pdf");

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

Crear PDF en servidores Blazor

IronPDF soporta .NET 6, y como incluye tipos de proyecto como Blazor, este fragmento de código proporciona un breve ejemplo de cómo crear PDFs en Servidor Blazor.

@code {

    // Model to bind user input
    private InputHTMLModel _InputMsgModel = new InputHTMLModel();

    private async Task SubmitHTML()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

        // Create a renderer to convert HTML to PDF
        var render = new IronPdf.ChromePdfRenderer();

        // Render the HTML input into a PDF document
        var doc = render.RenderHtmlAsPdf(_InputMsgModel.HTML);

        var fileName = "iron.pdf";

        // Create a stream reference for the PDF content
        using var streamRef = new DotNetStreamReference(stream: doc.Stream);

        // Invoke JavaScript function to download the PDF in the browser
        await JS.InvokeVoidAsync("SubmitHTML", fileName, streamRef);
    }

    public class InputHTMLModel
    {
        public string HTML { get; set; } = "My new message";
    }
}

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

Razor a PDF (Servidores Blazor)

Además de crear PDFs en Blazor Servers, IronPDF también es compatible con la generación de documentos PDF desde componentes Razor dentro de una página Blazor. Haciendo la creación de archivos y páginas PDF mucho más eficiente.

[Parameter]
public IEnumerable<PersonInfo> persons { get; set; }
public Dictionary<string, object> Parameters { get; set; } = new Dictionary<string, object>();
 
protected override async Task OnInitializedAsync()
{
    persons = new List<PersonInfo>
    {
        new PersonInfo { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
        new PersonInfo { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
        new PersonInfo { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
    };
}
private async void PrintToPdf()
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();
 
    // Apply text footer
    renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            LeftText = "{date} - {time}",
            DrawDividerLine = true,
            RightText = "Page {page} of {total-pages}",
            Font = IronSoftware.Drawing.FontTypes.Arial,
            FontSize = 11
        };
 
    Parameters.Add("persons", persons);
 
    // Render razor component to PDF
    PdfDocument pdf = renderer.RenderRazorComponentToPdf<Person>(Parameters);
 
    File.WriteAllBytes("razorComponentToPdf.pdf", pdf.BinaryData);
}

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

CSHTML a PDF

Convertir CSHTML (Razor) a PDF te permite generar documentos profesionales y listos para imprimir directamente desde tus aplicaciones web. Esto es útil para facturas, informes, contratos, o cualquier contenido dinámico. IronPDF soporta Páginas Razor, MVC Core, y MVC Framework, además de renderizado sin interfaz, haciéndolo fácil de integrar la generación de PDFs en tus aplicaciones .NET con solo unas pocas líneas de código.

CSHTML a PDF (Razor Pages)
using IronPdf.Razor.Pages;
 
public IActionResult OnPostAsync()
{
    persons = new List<Person>
    {
    new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
    new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
    new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
    };
 
    ViewData["personList"] = persons;
 
    ChromePdfRenderer renderer = new ChromePdfRenderer();
 
    // Render Razor Page to PDF document
    PdfDocument pdf = renderer.RenderRazorToPdf(this);
 
    Response.Headers.Add("Content-Disposition", "inline");
 
    return File(pdf.BinaryData, "application/pdf", "razorPageToPdf.pdf");
}

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

CSHTML a PDF (MVC Core)
public async Task<IActionResult> Persons()
{
    var persons = new List<Person>
    {
    new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
    new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
    new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
    };
    if (_httpContextAccessor.HttpContext.Request.Method == HttpMethod.Post.Method)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
 
        // Render View to PDF document
        PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Persons.cshtml", persons);
        Response.Headers.Add("Content-Disposition", "inline");
 
        // Output PDF document
        return File(pdf.BinaryData, "application/pdf", "viewToPdfMVCCore.pdf");
    }
    return View(persons);
}

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

CSHTML a PDF (Marco MVC)
public ActionResult Persons()
{
    var persons = new List<Person>
    {
    new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
    new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
    new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
    };
    if (HttpContext.Request.HttpMethod == "POST")
    {
        // Provide the path to your view file
        var viewPath = "~/Views/Home/Persons.cshtml";
        ChromePdfRenderer renderer = new ChromePdfRenderer();
 
        // Render Razor view to PDF document
        PdfDocument pdf = renderer.RenderView(this.HttpContext, viewPath, persons);
        Response.Headers.Add("Content-Disposition", "inline");
 
        // View the PDF
        return File(pdf.BinaryData, "application/pdf");
    }
    return View(persons);
}

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

CSHTML a PDF (sin encabezado)
app.MapGet("/PrintPdf", async () =>
{
    // Set your IronPDF license key
    IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
    
    // Enable detailed logging for troubleshooting
    IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

    // Render the Razor view to an HTML string
    string html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");

    // Create a new instance of ChromePdfRenderer 
    ChromePdfRenderer renderer = new ChromePdfRenderer();
   
    // Render the HTML string as a PDF document
    PdfDocument pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");

    // Return the PDF file as a response
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
});

Para una explicación más detallada de este fragmento de código y para explorar su funcionalidad adicional, por favor consulta nuestra exhaustiva guía práctica.

2. Cómo configurar los ajustes de HTML a PDF

En términos de manipulación de documentos PDF, IronPDF proporciona amplias personalizaciones a través de la propiedad ChromePdfRenderer.RenderingOptions para los PDFs renderizados.

ConfiguraciónDescripciónEjemplo
Tamaño de papelEstablecer las dimensiones de página para archivos PDF existentes (A4, Carta, Legal, etc.)PdfPaperSize.A4
Orientación del papelEstablecer vertical u horizontal para archivos PDF existentesPdfPaperOrientation.Paisaje
MargenSuperior/Inferior/Izquierda/DerechaEstablecer márgenes de página en milímetros (predeterminado: 25 mm)
CssMediaTypeCSS de pantalla o impresión para HTML a PDFPdfCssMediaType.Imprimir
ImprimirFondosHtmlIncluir colores/imágenes de fondo (predeterminado: verdadero)verdadero
HabilitarJavaScriptEjecutar JavaScript antes de renderizar el contenido HTMLverdadero
Esperar.RenderDelayTiempo de espera para contenido HTML dinámico (ms)500

Vea este fragmento de código para un ejemplo completo de configuración para manipular documentos PDF:

using IronPdf;
using IronPdf.Rendering;

var renderer = new ChromePdfRenderer();

// Apply print-specific CSS rules
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Set custom margins in millimeters
renderer.RenderingOptions.MarginTop = 50;
renderer.RenderingOptions.MarginBottom = 50;

// Enable background colors and images
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set paper size and orientation
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

// Generate PDFs with all settings applied to HTML content
var htmlContent = "<div style='background-color: #f0f0f0; padding: 20px;'><h1>Styled Content</h1></div>";
var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
pdfDocument.SaveAs("styled-output.pdf");
Consejos: Use PdfCssMediaType para obtener diseños más limpios y optimizados para impresión en su formato de archivo PDF renderizado. Use Pantalla para coincidir exactamente con lo que los usuarios ven en su navegador.

ARTÍCULOS RELACIONADOS:

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");

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");

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

3. Cómo utilizar las funciones avanzadas de generación y seguridad de PDF

Desbloquee capacidades a nivel empresarial para la conversión de HTML a PDF con plantillas avanzadas, operaciones asíncronas y características de seguridad. Estos métodos de manipulación de PDF le permiten crear documentos PDF a gran escala, proteger archivos PDF sensibles y asegurar la autenticidad de los documentos cuando convierte HTML a un formato PDF profesional.

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>

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");
}

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
SHELL
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");

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

Controlar saltos de página en PDF:

Gestionar la paginación en los documentos PDF generados garantiza diseños profesionales y legibles al convertir fragmentos de HTML. Usa CSS para controlar dónde se dividen las páginas en tus archivos PDF.

<!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>
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");
    }
}
Consejos: Consejos de optimización del rendimiento para la conversión de HTML a PDF
  • 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");

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");

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");
Advertencia: Cada campo de formulario en su HTML debe tener un atributo único name. Los nombres duplicados harán que los campos compartan el mismo valor en el PDF generado, llevando a un comportamiento inesperado cuando los usuarios llenen el formulario.

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");

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");

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");
Consejos: Para inicios de sesión basados en formularios HTML (POST usuario/contraseña), considere usar HttpClient para autenticar primero, luego pase las cookies resultantes al diccionario CustomCookies para renderizar la página protegida.

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

¿Cómo puedo generar archivos PDF a partir de múltiples fragmentos HTML?

Para generar archivos PDF combinando fragmentos HTML, puedes fusionarlos . Esto crea informes de varias secciones o combina contenido de diferentes fuentes:

var renderer = new ChromePdfRenderer();

PdfDocument part1 = renderer.RenderHtmlAsPdf("<h1>Section 1</h1><p>First section content</p>");
PdfDocument part2 = renderer.RenderHtmlAsPdf("<h1>Section 2</h1><p>Second section content</p>");

var merged = PdfDocument.Merge(part1, part2);
merged.SaveAs("Merged.pdf");

// Alternative approach: copy specific pages
var combinedDoc = new PdfDocument();
combinedDoc.CopyPage(part1, 0); // Copy first page
combinedDoc.CopyPage(part2, 0); // Copy first page
combinedDoc.SaveAs("Combined.pdf");

Esto ayuda a la hora de crear informes de varias secciones a partir de diferentes fragmentos HTML. También puedes agregar marcadores para mejorar la navegación.

Interfaz de Adobe Acrobat que muestra un documento PDF con el encabezado 'Sección 1' y un panel Páginas que muestra miniaturas de la Sección 1 y la Sección 2.

¿Cómo convierto HTML a PDF en las API web?

En ASP.NET Web API, genere y devuelva archivos PDF sin guardarlos en el disco usando MemoryStream . Este patrón es ideal para aplicaciones Blazor y servicios RESTful:

[HttpGet("download")]
public IActionResult GetPdf()
{
    var renderer = new ChromePdfRenderer();
    string html = "<h1>Web Report</h1><p>Generated dynamically.</p>";

    var pdf = renderer.RenderHtmlAsPdf(html);
    var bytes = pdf.BinaryData;

    // Optional: Add metadata
    pdf.MetaData.Author = "API Service";
    pdf.MetaData.CreationDate = DateTime.Now;

    return File(bytes, "application/pdf", "report.pdf");
}

Este patrón funciona muy bien para la generación de PDF del lado del servidor en aplicaciones web .NET 10. Puede integrarse con vistas CSHTML para aplicaciones MVC.

¿Cómo agregar encabezados, marcas de agua y seguridad?

Cómo agregar encabezados y pies de página profesionales

Los encabezados y pies de página que muestran números de página, fechas o marca hacen que los documentos de varias páginas sean mucho más legibles y profesionales. IronPDF los procesa como fragmentos HTML, por lo que puede utilizar el estilo CSS completo, incluidas imágenes y colores de marca:

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 50,
    HtmlFragment = "<div style='text-align:center;font-size:12px;'>Annual Report 2025 -- Confidential</div>",
    BaseUrl = new Uri(@"file:///C:/assets/")
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 30,
    HtmlFragment = "<div style='text-align:center;font-size:10px;'>Page {page} of {total-pages}</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.MarginTop = 60;
renderer.RenderingOptions.MarginBottom = 40;

var pdf = renderer.RenderHtmlAsPdf("<h1>Report Content</h1><p>Body text here.</p>");
pdf.SaveAs("report-with-headers.pdf");

Los marcadores de posición como {page} y {total-pages} se reemplazan automáticamente al momento de renderizar. Revise el tutorial de encabezados y pies de página para la inyección dinámica de fechas, colocación de logotipos y estilos de página alternos.

Aplicación de marcas de agua, cifrado y firmas digitales

Las marcas de agua protegen borradores de documentos e informes confidenciales. La protección con contraseña y la configuración de permisos restringen quién puede imprimir, copiar o editar un PDF. Las firmas digitales añaden una capa de autenticidad verificable para los contratos y documentos regulados. Puedes combinar los tres en un único flujo de trabajo:

using IronPdf;
using System.Security.Cryptography.X509Certificates;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1><p>Terms and conditions.</p>");

// Watermark
pdf.ApplyWatermark(
    "<div style='font-size:72px;color:red;opacity:0.3;'>DRAFT</div>",
    rotation: 45,
    opacity: 30
);

// Encryption and permissions
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

// Digital signature
var cert = X509CertificateLoader.LoadPkcs12FromFile("certificate.pfx", "password");
var signature = new PdfSignature(cert)
{
    SigningContact = "Jane Smith",
    SigningLocation = "New York, NY",
    SigningReason = "Contract Approval"
};
pdf.Sign(signature);
pdf.SaveAsRevision("signed-contract.pdf");

Obtenga información sobre técnicas de marca de agua , configuraciones de seguridad de PDF y firma basada en certificados , incluida la integración de HSM para módulos de seguridad de hardware.

Mi biblioteca favorita de este tipo es IronPDF. Permite una manipulación rápida y eficiente de archivos PDF. También tiene muchas funciones valiosas, como exportar al formato PDF/A y firmar documentos PDF digitalmente.

Milan Jovanovic

Microsoft MVP

Ver estudio de caso

IronOCR significa que podemos ahorrar $40,000 anualmente en el procesamiento manual, mientras mejoramos la productividad y liberamos recursos para tareas de alto impacto. Lo recomendaría encarecidamente.

Brent Matzelle

Director de Tecnología, OPYN

Ver estudio de caso

El Iron Suite juega un papel crucial en nuestras operaciones. Estas son herramientas que aumentan la eficiencia en toda la empresa, incluyendo la creación de planos y la mejora en la gestión de inventario.

David Jones

Ingeniero de Software Principal, Agorus Build

Ver estudio de caso

4. Cómo implementar HTML a PDF en plataformas en la nube

La implementación de la conversión de HTML a PDF en entornos en la nube requiere una configuración específica para el renderizado sin cabeza, rutas de archivos temporales y asignación de recursos. Esta sección cubre las plataformas en la nube más comunes y los despliegues con contenedores con IronPDF.

PlataformaRecursos mínimosPaqueteAutoConfigRuta temporalElemento clave
Azure App ServiceNivel B1 (Básico)IronPdf.Linuxtrue/tmpLos niveles gratuitos/compartidos fallan: sin GPU, poca memoria
Azure Functions (Windows)Nivel B1IronPdftrue/tmpDesmarque 'Ejecutar desde el archivo del paquete'
AWS Lambda512 MB / tiempo de espera de 330sIronPdf.Linuxtrue/tmp (requerido)El sistema de archivos predeterminado es de solo lectura
Docker (Ubuntu/Debian)Dependiente de la imagenIronPdf.LinuxfalsePor defecto de la imagenEstablezca false — Dockerfile maneja deps

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");
Precaución: Los niveles gratuitos y compartidos de Azure App Service (F1, D1) no tienen suficientes recursos para el renderizado PDF basado en Chrome. Utilice al menos un nivel B1 (Básico) o superior para evitar errores de memoria insuficiente y tiempo de espera de procesos.

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;
    }
}
Por favor nota: Configure su función Lambda con al menos 512 MB de memoria y un tiempo de espera mínimo de 60 segundos. El renderizado basado en Chrome consume mucha memoria y los inicios en frío requieren tiempo de inicialización adicional para el motor de navegador integrado.

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.

PlataformaPaqueteConfiguración clave
Ubuntu 22.04 / DebianIronPdf.LinuxPor defecto: funciona de inmediato
Alpine LinuxIronPdf.LinuxInstale chromium a través de apk en Dockerfile
Amazon Linux 2IronPdf.LinuxUtilice LinuxAndDockerDependenciesAutoConfig = true
Contenedores de WindowsIronPdfNo se requiere configuración adicional

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"]
Text

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");

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

¿Cómo se puede optimizar y escalar el rendimiento de HTML a PDF en .NET Core?

El motor Chromium de IronPDF ya renderiza la mayoría de las páginas en < 1 s en hardware moderno, pero el rendimiento se puede multiplicar mediante procesos por lotes, habilitando el multihilo, y reduciendo la sobrecarga de Headless Chrome. ### 1. Agregar renderizados en un fondo de subprocesos

1. Renderizado por lotes en un grupo de hilos en segundo plano

// BatchRender.cs — Thread-safe on .NET 8+
using IronPdf;
using System.Threading.Tasks;

var htmlSources = Directory.GetFiles("./html", "*.html");
var renderer    = new ChromePdfRenderer();                 // reuse 1 instance

Parallel.ForEach(htmlSources, new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount }, file =>
{
    string html = File.ReadAllText(file);
    using PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs(Path.ChangeExtension(file, ".pdf"));
});

2. Reduzca el costo de inicio de Headless Chrome

La agrupación ayuda, y contenedores Linux deben incluir dos bibliotecas nativas: La falta de bibliotecas se manifiesta como el error "libnss3.so no encontrado" en registros de Docker.

RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0
Text

La falta de cualquiera de las bibliotecas se manifiesta como un error libnss3.so not found en los registros de Docker.

Las banderas de Chrome recomendadas (aplicadas automáticamente por IronPDF) incluyen --disable-gpu y --no-sandbox para reducir la memoria y problemas de usuarios root en contenedores.

3. Esperar JavaScript tardío con RenderDelay o WaitFor

Las páginas que animan contadores o recuperan datos después de DOMContentLoaded pueden necesitar un breve retraso:

renderer.RenderingOptions.RenderDelay = 200;        // ms
// OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

Consulte el tutorial WaitFor dedicado para promesas personalizadas y sondeo del DOM.

4. Habilitar el registro de depuración para una solicitud

renderer.LoggingOptions.DebugMode        = true;
renderer.LoggingOptions.LogsToConsole    = true;
renderer.LoggingOptions.LogFilePath      = "./logs/ironpdf-debug.log";

5. Reutilizar PDFs de plantilla en lugar de renderizar de nuevo

5. Reutilizar plantillas PDF en lugar de volver a renderizar

Para corridas de facturas, crea un PDF de plantilla con marcadores de posición como [[name]] y realiza un reemplazo de texto en lugar de reconstruir HTML complejo. ### Lista de verificación rápida de ajuste

Lecturas adicionales


5. Comparar IronPDF con otras bibliotecas PDF de .NET

IronPDF es la solución preferida para muchos equipos cuando se trata de generación de PDF en C# gracias a su robusto motor de renderizado potenciado por Chromium, APIs intuitivas y mejoras frecuentes de producto. Compararemos IronPDF con otros convertidores de PDF para encontrar la mejor solución para sus necesidades de generación de PDF.

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

SoluciónCuándo utilizarloBest para
IronPDFConversión de sitios web modernos/HTML a PDF con fidelidad visual exacta.Aplicaciones empresariales que requieren un motor de renderizado HTML confiable, contenido dinámico y soporte profesional.
wkhtmltopdfConversión de HTML simple en aplicaciones no críticas donde la representación obsoleta es aceptable.Generación básica de documentos con HTML/CSS heredado.
Fusión de sincronizaciónCuando ya haya invertido en el ecosistema Syncfusion o sea elegible para obtener una licencia comunitaria gratuita.Organizaciones que utilizan múltiples componentes de Syncfusion.
Aspose.PDFManipulación compleja de PDF cuando la calidad de representación HTML es menos crítica.Amplias funciones de edición de PDF más allá de la conversión a HTML.

COMPARACIONES RELACIONADAS:

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

Función★ RecomendadoIronPDFwkhtmltopdfiTextAspose.PDFSyncfusionApryseSelectPdfSpire.PDFPDFSharpQuestPDF
Rendering & Conversion
Precisión de representaciónLo mejor en píxeles perfectosEstilo de impresiónSólo programáticoBienBienBienBienNivel bajoSin renderizadoDiseño basado en código
Compatibilidad con HTML5LlenoAnticuadoAñadirParcialLlenoMóduloLlenoLimitadoNoNo (Código primero)
Compatibilidad con CSS3LlenoLimitadoAñadirParcialLlenoMóduloLlenoLimitadoNoNo (Código primero)
Ejecución de JavaScriptCompletoMejorNoNoCuestionadoLimitadoLimitadoLimitadoMuy limitadoNoNo
HTML→PDF (Diseño moderno)Chromium integrado BestQt WebKit (obsoleto)Complemento de pagoParcial; JS DisputadoMotor BlinkRequiere móduloHTML→PDF completoBasado en imágenesNoNo es un renderizador HTML
PDF→Renderizado de imágenesNoNoLimitadoNoSolo documentos propios
Operaciones de documentos
Generar archivos PDF mediante programaciónNoSólo HTMLBásicoSí (API fluida)
Merge, Split & RearrangeNoLimitado
Encabezados / Pies de página / Números de páginaHTML/Texto/Imagen BestLimitadoVía EventosVía EventosPlantillasManualSolo manualTragamonedas de primera clase
Watermarks & StampingTexto e imagenNoLimitadoNoSí (superposiciones)
Extraer texto de PDFsNoBásicoNo
OCR para archivos PDF escaneadosA través de IronOCR integradoNoAñadirProducto separadoAñadirAñadirNoSolución alternativaNoNo
Security & Compliance
Firmas DigitalesNoCódigo de muestraNoNoNo documentado
Cumplimiento de PDF/ASí (PDF/A-3B)NoPDF/A completoValidar y crearRequiere SDK nativoCumplimiento de PDFANoLimitadoPDF/A-2x y 3x
Plataforma & Developer Experience
MultiplataformaWindows · Linux · macOS Los 3Depende de los binarios.NET Standard 2.0Configuración adicional de LinuxServidor Blink + .NETSDK nativoSólo Windows *Documentación limitada de LinuxCentrado en WindowsWindows/Linux/MacOS
Cloud & Docker DeployAzure · AWS · Docker BestComplejo; LegadoPaquetes múltiplesParcial; ContenedoresSe necesitan extras de BlinkDepartamentos nativosSólo para WindowsInformación limitadaSimple; ligeroDocker/K8s; Local
Support & Documentación
DocumentaciónExtenso + Copiar/Pegar BestDocumentación parcial de la CLIExtenso; KBAmplio; GitHubCentro de ayudaCatálogo multilingüeGuías de introducciónGuía del programaGuías de la comunidadAplicación estructurada y complementaria
Soporte a desarrolladoresLos mejores ingenieros 24/7Solo para la comunidadSuscripción incluidaForo + PagoTracción directa 24/5ComercialEmailForo + Correo electrónicoSolo para la comunidadComunidad + GitHub
Licensing & Pricing
Modelo de licenciaPerpetuoCódigo abiertoAGPL / SuscripciónPerpetuoSuscripción anualCostumbre / ConsumoPerpetuoSuscripción anualGratis (MIT)Niveles gratuitos y de pago del MIT
Precio inicial$999Perpetua · 1 Desarrollador style="color:#16a34a">Gratis~K/anualCotización personalizada,175+Por desarrollador5/anualSuscripción · Gratis <M~K+/anualCotización personalizada9+Perpetua9/anualSuscripción anual style="color:#16a34a">Gratis style="color:#16a34a">GratisComunidad MIT <M
Prueba gratuita30 días · Funciones completas sin límitesN/A (Gratis)30 díasSí (con marca de agua)Community <$1M RevComunidad (5 páginas)Gratis (10 páginas)N/A (Gratis)N/A (MIT Free <$1M)
Transparencia de preciosPublicado y claro mejorCódigo abiertoAGPL complejoMuchos nivelesContacto para cotizaciónSin precios publicadosPublicadoPublicadoMIT; Sin restriccionesMIT; Basado en la confianza

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/

Captura de pantalla de la página de inicio de Reddit mostrando contenido dinámico, estilo moderno y elementos interactivos usados para pruebas de conversión a PDF

IronPDF

Resultado de la conversión con IronPDF mostrando un renderizado perfecto de la página de inicio de Reddit con todo el contenido dinámico, estilos y elementos interactivos preservados

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

Conversión de PDF de Syncfusion mostrando renderizado parcial con secciones faltantes y estilo incompleto de la página de inicio de Reddit

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

Intento de conversión de Aspose.PDF mostrando capturas de contenido mínimas con la mayoría de los elementos de la página faltantes desde la página de inicio de Reddit

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

Salida de wkhtmltopdf mostrando una versión estática y sin estilo de la página de inicio de Reddit sin elementos dinámicos o CSS moderno

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

Conversión de HTML a PDF en el contexto español: Facturae, VeriFactu y TicketBAI

La conversión de HTML a PDF tiene una aplicación regulatoria directa en España, donde múltiples sistemas fiscales exigen la generación de documentos PDF a partir de plantillas HTML.

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 VERI*FACTU (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.

Para una implementación paso a paso, consulte la guía de generación de facturas en C# .NET para VeriFactu, TicketBAI y Facturae.

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. Si genera estos modelos a partir de informes heredados, la guía de migración desde SAP Crystal Reports a IronPDF en C# muestra cómo trasladar esas plantillas a HTML.

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.

Accesibilidad de PDFs para el sector público

Los organismos públicos españoles deben cumplir el Real Decreto 1112/2018 sobre accesibilidad de sitios web y aplicaciones del sector público. La guía de accesibilidad de PDFs en C# para el sector público español explica cómo generar documentos PDF etiquetados y accesibles conforme a esa normativa.

6. Solución de problemas y soporte técnico

¿Tienes problemas con los siguientes errores en la conversión de HTML a PDF? IronPDF ofrece soporte de ingenieros 24/7 mediante el widget de chat en https://ironpdf.com/

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

Próximos pasos
Cómo fusionar o dividir documentos PDFVer cómo hacerlo
Cómo agregar encabezados y pies de página personalizados a archivos PDFVer cómo hacerlo
Cómo redactar texto y regiones en PDFVer cómo hacerlo

Preguntas Frecuentes

¿Cómo convierto HTML a PDF en C#?

Puedes convertir HTML a PDF en C# utilizando una biblioteca de renderizado de Chrome que convierte HTML, CSS3 y JavaScript en PDF perfectos. Herramientas como IronPDF permiten renderizar a partir de URL, cadenas HTML o archivos y admiten cabeceras, autenticación y ajustes de impresión.

¿Cuál es la mejor biblioteca HTML a PDF for .NET?

La mejor biblioteca debería admitir la representación precisa de Chrome, la implementación multiplataforma y las características empresariales. IronPDF cubre todo esto: funciona en Windows, Linux, macOS y Docker, con soporte para seguridad, firmas, cumplimiento y aplicaciones escalables .NET.

¿Cuáles son las opciones gratuitas de HTML a PDF for .NET?

Rutas de código abierto como wkhtmltopdf, PuppeteerSharp y Playwright convierten HTML a PDF sin costo, pero intercambian conveniencia por mantenimiento — motores de renderizado más antiguos, binarios de navegador incluidos o configuración manual del servidor. IronPDF es comercial, con una prueba gratuita de 30 días que tiene todas las funciones y sin marcas de agua durante el desarrollo; las licencias de producción comienzan en $999. Ver precios →

¿Cómo puedo convertir cadenas HTML a PDF usando C#?

Para convertir cadenas HTML a PDF, usa la clase ChromePdfRenderer y su método RenderHtmlAsPdf. Pasa tu cadena HTML a este método, luego guarda el PDF usando SaveAs.

¿Cuáles son los pasos para convertir una URL de página web a un documento PDF en C#?

Puedes convertir una URL de página web directamente en un PDF usando el método RenderUrlAsPdf, lo que te permite conservar estilos, imágenes y elementos interactivos como formularios e hipervínculos.

¿Cómo convierto un archivo HTML a PDF en C#?

Usa ChromePdfRenderer.RenderHtmlFileAsPdf("path/to/file.html") para convertir archivos HTML locales a PDF. IronPDF resuelve automáticamente todas las rutas de recursos relativos (imágenes, CSS, JS).

¿Cómo convierto las Razor Pages de ASP.NET o las Vistas MVC a PDF?

IronPDF proporciona paquetes de extensiones dedicados — IronPdf.Extensions.Razor para Razor Pages y IronPdf.Extensions.Mvc.Core para Vistas MVC. Usa RenderRazorToPdf o RenderRazorViewToPdf con inyección de dependencias para convertir vistas directamente a PDF desde tus controladores. Ver guía de Razor →

¿Cómo aseguro que el contenido JavaScript se renderice correctamente en el PDF?

Habilita la representación de JavaScript configurando RenderingOptions.EnableJavaScript = true y agrega un retraso de renderizado usando RenderingOptions.WaitFor.RenderDelay para asegurar que el contenido dinámico esté completamente cargado antes de la conversión. Ver guía de WaitFor →

¿Por qué mi salida de HTML a PDF está en blanco o falta contenido?

Un PDF en blanco o parcial casi siempre significa que la página no había terminado de renderizarse cuando fue capturada, o sus recursos no se cargaron. Para contenido dinámico o impulsado por JavaScript, configure RenderingOptions.EnableJavaScript = true y agregue un WaitFor.RenderDelay (o WaitFor.HtmlQuerySelector) para que Chrome termine de pintar primero. Si faltan imágenes locales, CSS o fuentes, pase un BaseUrlPath para que las rutas relativas se resuelvan correctamente. Ver guía de WaitFor →

¿Cuál es el mejor método para agregar encabezados y pies de página a un PDF en C#?

Usa la clase TextHeaderFooter para encabezados y pies de página de texto simples, o la clase HtmlHeaderFooter para contenido HTML más complejo. Puedes incluir marcadores de posición dinámicos como {page}, {total-pages} y {date} para generación automática de contenido. Ver guía de encabezados y pies de página →

¿Cómo manejo saltos de página en la salida del PDF en C# .NET?

Controla los saltos de página en tus PDFs utilizando propiedades CSS como page-break-after: always y page-break-inside: avoid dentro de un bloque de media de impresión CSS. Ver guía de saltos de página →

¿Qué opciones están disponibles para configurar el tamaño del papel y la orientación en los PDFs?

Configura el tamaño del papel usando RenderingOptions.PaperSize (las opciones incluyen A4, Carta, Legal, etc.) y la orientación con RenderingOptions.PaperOrientation para Retrato o Paisaje. También se admiten tamaños personalizados en milímetros o pulgadas. Ver guía de tamaño de papel →

¿Puedo convertir páginas web autenticadas a PDF?

Sí. IronPDF admite cookies, encabezados HTTP personalizados y autenticación basada en formularios. Configura las cookies a través de ChromePdfRenderer.RenderingOptions.CustomCookies, o pasa encabezados de autenticación para autenticación basada en tokens. También se admite la autenticación Windows NTLM y Kerberos. Ver guía de cookies →

¿Puedo crear múltiples PDFs a partir de una plantilla HTML única en C#?

Sí, crea plantillas HTML con marcadores de posición, luego usa reemplazo de cadenas o bibliotecas de plantillado como Handlebars.NET. Sustituye los marcadores de posición con valores reales en tus datos iterados y genera PDFs usando RenderHtmlAsPdf.

¿Es posible asegurar mis PDFs generados con una contraseña?

Sí, puedes usar la propiedad SecuritySettings para configurar contraseñas de usuario y propietario, configurar permisos como imprimir y copiar, y aplicar cifrado AES256 con SecuritySettings.EncryptionAlgorithm. Ver guía de cifrado →

¿Puedo generar documentos compatibles con PDF/A desde HTML?

Sí. IronPDF admite los estándares PDF/A-1b, PDF/A-2b, PDF/A-3b y PDF/UA para cumplimiento de archivo y accesibilidad, lo cual la mayoría de los convertidores HTML a PDF no ofrecen. Ver guía PDF/A →

¿Cómo puedo optimizar el rendimiento para generar un gran volumen de PDFs?

Optimiza el rendimiento usando métodos asincrónicos como RenderHtmlAsPdfAsync para operaciones no bloqueantes. Reutiliza instancias de ChromePdfRenderer, procesa múltiples PDFs de forma concurrente utilizando Task.WhenAll, y asegúrate de tener recursos de servidor adecuados en un sistema de 64 bits. Ver guía asincrónica →

¿Cómo puedo combinar múltiples PDFs o incluir una página de portada en mi documento?

Usa el método estático PdfDocument.Merge para combinar múltiples PDFs. Genera tu página de portada por separado y combínala con tu documento principal para crear un PDF completo. Ver guía de combinación →

¿Puedo desplegar IronPDF en Azure, AWS, o Docker?

Sí. IronPDF funciona en Azure App Service, Azure Functions, AWS Lambda y contenedores Docker en Linux. Guías de configuración dedicadas e imágenes Docker están disponibles para cada plataforma. Ver guía de Azure → · Ver guía de AWS → · Ver guía de Docker →

Compatibilidad con .NET 10: ¿IronPDF admite .NET 10 de inmediato?

Sí — IronPDF es totalmente compatible con .NET 10. Según las notas de lanzamiento de IronPDF, la biblioteca está lista desde el primer día para proyectos .NET 10, sin necesidad de configuración adicional. Ya sea que estés utilizando aplicaciones web, de consola, de escritorio, o microservicios, IronPDF funciona "out of the box" con .NET 10.

¿Es IronPDF gratuito?

IronPDF ofrece una prueba gratuita de 30 días con funcionalidad completa y sin marcas de agua en el desarrollo. El uso en producción requiere una licencia comercial a partir de $999. Están disponibles los niveles Lite, Plus, Professional y Enterprise. Ver precios →

¿Cómo se compara la calidad de representación de esta biblioteca con otras opciones como wkhtmltopdf?

Esta biblioteca usa un motor de renderizado Chrome moderno para PDFs perfectos en píxeles, a diferencia del desactualizado motor WebKit de wkhtmltopdf. No requiere ejecutables de servidor, soporta JavaScript/CSS3 completo, recibe actualizaciones regulares y ofrece soporte profesional.

¿Por qué debería elegir esta biblioteca en lugar de PDFSharp para la conversión de HTML a PDF?

PDFSharp carece de conversión HTML a PDF integrada, requiriendo soluciones complicadas. Esta biblioteca ofrece conversión directa de HTML/URL/archivo con una API de alto nivel, soporte para tecnologías web modernas y actualizaciones regulares con soporte profesional. Ver comparación con PDFSharp →

¿Por qué es esta una mejor opción que iTextSharp para la conversión de HTML?

La versión gratuita de iTextSharp no admite la conversión nativa de HTML a PDF y tiene una API de bajo nivel compleja. Esta biblioteca proporciona una conversión de HTML sin problemas con una API intuitiva, soporte completo para CSS3/JavaScript, y sin restricciones de licencia AGPL. Ver comparación con iTextSharp →

¿Cómo se compara la calidad de renderizado de esta biblioteca con Aspose.PDF?

Esta biblioteca produce PDFs de calidad Chrome perfectamente pixelada, mientras que Aspose.PDF a menudo omite estilos y contenido dinámico. Aspose requiere descargas HTML manuales para la conversión de URL, pero esta biblioteca convierte URLs directamente con mayor precisión. Ver comparación con Aspose →

¿Por qué podría elegir esta biblioteca sobre Syncfusion PDF?

Si bien Syncfusion es capaz, el motor optimizado de Chrome de esta biblioteca funciona más rápido y maneja el contenido dinámico de manera más efectiva. Ofrece una API más sencilla y características adicionales como generación de OCR y código de barras. Ver comparación con Syncfusion →

Jacob Mellor, Director de Tecnología @ Team Iron
Director de Tecnología

Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.

...
Leer más

¿Listo para empezar?

Nuget Downloads 20,878,335Versión:2026.9recién publicada

Obtén tu GRATIS

Clave de prueba de 30 días instantáneamente.

bullet_checkedNo se requiere tarjeta de crédito ni creación de cuenta
bullet_testPrueba en producción
sin marcas de agua
bullet_calendarProducto completamente
funcional por 30 días
bullet_supportSoporte técnico 24/5
durante la prueba
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta