Cómo utilizar las opciones de renderizado en IronPDF con C#

This article was translated from English: Does it need improvement?
Translated
View the article in English

Las opciones de renderizado en IronPDF personalizan la generación de PDF a través de la clase ChromePdfRenderer, controlando ajustes como márgenes, encabezados, pies de página, tamaño del papel, ejecución de JavaScript y tipos de medios CSS para crear documentos PDF con un formato preciso a partir de HTML, CSS y otras fuentes de contenido.

como-encabezado:2(Inicio rápido: Aplicar opciones de renderizado en C#)

  1. Instalación de IronPDF mediante el gestor de paquetes NuGet
  2. Crear una instancia de ChromePdfRenderer
  3. Configurar las opciones de renderizado a través de la propiedad RenderingOptions
  4. Convierta su contenido (HTML, Markdown, etc.) a PDF
  5. Guardar el documento PDF resultante

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronPDF con el gestor de paquetes NuGet

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaEscriba a = IronPdf.Rendering.PdfCssMediaEscriba a.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
        .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
        .SaveAs("renderingOptions.pdf");
  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronPDF en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

Las opciones de renderizado en la generación de PDF son ajustes que determinan cómo se crea, muestra e imprime un documento PDF. Estas opciones incluyen la representación de elementos de formulario, la activación de JavaScript, la generación de tablas de contenido, la adición de encabezados y pies de página, el ajuste de márgenes, la configuración del tamaño del papel, etc.

La clase ChromePdfRenderer de IronPDF ofrece varias opciones de renderizado para personalizar la generación de PDF. Incluye PaperFit, un gestor que controla el diseño del contenido en las páginas PDF, ofreciendo diferentes estilos como diseños CSS3 responsivos o alimentación continua. Cuando se trabaja con documentos complejos, es posible que sea necesario combinar o dividir los PDF después de aplicar las opciones de renderizado.


## ¿Cómo se utilizan las opciones de renderizado en IronPDF? Aunque muchas propiedades de las opciones de renderizado están diseñadas para la conversión de HTML a PDF, también funcionan con otros tipos de conversión de PDF. Vamos a convertir Markdown a PDF y a configurar el resultado mediante las opciones de conversión. Para conversiones de HTML en concreto, infórmese sobre la conversión de archivos HTML a PDF o la conversión de cadenas HTML a PDF. ### ¿Por qué debo configurar las opciones de renderizado? La configuración de las opciones de renderizado garantiza que los PDF se generen con las especificaciones exactas: tamaños de papel personalizados, márgenes específicos, encabezados y pies de página o JavaScript activado para contenido dinámico. Este control es crucial a la hora de crear nuevos PDF para documentos o informes profesionales. ### ¿Qué ocurre cuando aplico varias opciones de renderizado? Varias opciones de renderizado colaboran para crear el resultado final en PDF. Cada opción modifica un aspecto específico del renderizado, y IronPDF las aplica secuencialmente durante la conversión. Por ejemplo, al establecer márgenes y encabezados, el contenido del encabezado respeta la configuración de márgenes a menos que se anule mediante la propiedad `UseMarginsOnHeaderAndFooter`. ```csharp :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ```### Ejemplo de opciones de renderizado avanzadas Este completo ejemplo demuestra la combinación de varias opciones de renderizado para la generación de documentos profesionales. Este enfoque resulta útil cuando es necesario [añadir encabezados y pies de página](https://ironpdf.com/how-to/headers-and-footers/) o trabajar con [tamaños de papel personalizados](https://ironpdf.com/how-to/custom-paper-size/): ```csharp using IronPdf; using IronPdf.Rendering; // Create renderer with advanced options var renderer = new ChromePdfRenderer(); // Configure paper and layout settings renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait; renderer.RenderingOptions.PaperSize = PdfPaperSize.A4; renderer.RenderingOptions.PrintHtmlBackgrounds = true; // Set margins for professional layout renderer.RenderingOptions.MarginTop = 40; // mm renderer.RenderingOptions.MarginBottom = 40; // mm renderer.RenderingOptions.MarginLeft = 20; // mm renderer.RenderingOptions.MarginRight = 20; // mm // Enable JavaScript for dynamic content renderer.RenderingOptions.EnableJavaScript = true; renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 seconds for JS to execute // Add professional header with page numbers renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter { Height = 25, HtmlFragment = @"
Document Title - Page {page} of {total-pages}
", DrawDividerLine = true }; // Add footer with timestamp renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter { Height = 20, HtmlFragment = @"
Generated on {date} at {time}
" }; // Render HTML content string htmlContent = @"

This document demonstrates advanced rendering options.

"; PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("professional-document.pdf"); ```
## ¿Cuáles son todas las opciones de renderizado disponibles? Las opciones avanzadas definen los ajustes de renderizado de PDF, como márgenes, orientación del papel, tamaño del papel, etc. La comprensión de estas opciones ayuda cuando se necesita establecer márgenes personalizados o trabajar con diferentes configuraciones de ventana gráfica y niveles de zoom. ### ¿Cuáles son las opciones de renderizado más utilizadas? Entre las opciones de renderización más utilizadas se incluyen la configuración de márgenes, la configuración del tamaño del papel, la configuración del encabezado/pie de página y la habilitación de JavaScript. Estas opciones cubren la mayoría de las necesidades de personalización de PDF. Para los contenidos basados en web, las opciones de representación de JavaScript garantizan que los elementos dinámicos se representen correctamente. ### ¿Cómo elegir las opciones de renderizado adecuadas? Elija las opciones de representación en función de sus necesidades: utilice la configuración de márgenes para diseños de impresión, active JavaScript para contenidos web dinámicos, configure encabezados/pies de página para documentos profesionales y ajuste el tamaño del papel para formatos de salida específicos. Cuando trabaje con contenido web, tenga en cuenta los tipos de medios CSS para una representación óptima. ### ¿Cuándo debo utilizar las opciones avanzadas de renderizado? Utilice las opciones avanzadas de renderizado para funciones especializadas como la inyección de CSS personalizada, el renderizado matemático LaTeX, la salida en escala de grises o cuando trabaje con aplicaciones web complejas que requieran un tiempo de ejecución de JavaScript específico. La clase WaitFor proporciona un control preciso sobre los retrasos de renderización en escenarios complejos. ### Trabajo con elementos de formulario Cuando el HTML contiene elementos de formulario, IronPDF los convierte automáticamente en formularios PDF interactivos: ```csharp using IronPdf; var renderer = new ChromePdfRenderer(); // Enable PDF form creation from HTML forms renderer.RenderingOptions.CreatePdfFormsFromHtml = true; // HTML with form elements string formHtml = @"



"; PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml); pdfWithForms.SaveAs("interactive-form.pdf"); ``` A continuación se muestra una tabla que ilustra las distintas opciones disponibles.
ClaseChromePdfRenderer
DescripciónSe utiliza para definir las opciones de impresión de PDF, como el tamaño del papel, los PPP, los encabezados y los pies de página
Propiedades / funcionesEscriba aDescripción
`CustomCookies``Dictionary<string, string>`Cookies personalizadas para el renderizado HTML. Las cookies no persisten entre renderizaciones y deben configurarse cada vez.
`PaperFit``VirtualPaperLayoutManager`A manager for setting up virtual paper layouts, controlling how content will be laid out on PDF "paper" pages. Includes options for Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups.
`UseMarginsOnHeaderAndFooter``UseMargins`Utilice los valores de los márgenes del documento principal para los encabezados y pies de página.
`CreatePdfFormsFromHtml``bool`Convierte todos los elementos de formulario HTML en formularios PDF editables. El valor por defecto es true.
`CssMediaEscriba a``PdfCssMediaEscriba a`Habilita los estilos CSS y las hojas de estilo Media="screen". El valor por defecto es PdfCssMediaEscriba a.Screen.
`CustomCssUrl``string`Permite aplicar una hoja de estilo CSS personalizada a HTML antes de la renderización. Puede ser una ruta de archivo local o una URL remota. Sólo aplicable al convertir HTML a PDF.
`EnableJavaScript``bool`Permite ejecutar JavaScript y JSON antes de renderizar la página. Ideal para imprimir desde aplicaciones Ajax / Angular. El valor por defecto es false.
`EnableMathematicalLaTex``bool`Permite la representación de elementos matemáticos LaTeX.
`Javascript``string`Una cadena JavaScript personalizada que se ejecutará después de que se haya cargado todo el HTML pero antes de la renderización del PDF.
`JavascriptMessageListener``StringDelegate`Un método de devolución de llamada que se invocará cada vez que un mensaje de la consola JavaScript del navegador esté disponible.
`FirstPageNumber``int`Primer número de página que se utilizará en los encabezados y pies de página del PDF. El valor predeterminado es 1.
`TableOfContents``TableOfContentsEscriba as`Genera un índice en el lugar del documento HTML donde se encuentra un elemento con id "ironpdf-toc".
`GrayScale``bool`Genera un PDF en blanco y negro. El valor por defecto es false.
`TextHeader``ITextHeaderFooter`Establece el contenido del pie de página de cada página PDF como texto, admite la combinación de correspondencia y convierte automáticamente las URL en hipervínculos.
`TextFooter`
`HtmlHeader``HtmlHeaderFooter`Establece el contenido de la cabecera de cada página PDF como HTML. Admite 'mail-merge'.
`HtmlFooter`
`InputEncoding``Encoding`La codificación de caracteres de entrada como cadena. El valor por defecto es Encoding.UTF8.
`MarginTop``double`Margen "papel" superior del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
`MarginRight``double`Margen "papel" derecho del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor predeterminado es 25.
`MarginBottom``double`Margen "papel" inferior del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor predeterminado es 25.
`MarginLeft``double`Margen "papel" izquierdo del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor predeterminado es 25.
`PaperOrientation``PdfPaperOrientation`La orientación del papel PDF, como Vertical u Horizontal. El valor predeterminado es Vertical.
`PaperSize``PdfPaperSize`Establece el tamaño del papel
`SetCustomPaperSizeinCentimeters``double`Establece el tamaño del papel en centímetros.
`SetCustomPaperSizeInInches`Establece el tamaño del papel en pulgadas.
`SetCustomPaperSizeinMilimeters`Establece el tamaño del papel en milímetros.
`SetCustomPaperSizeinPixelsOrPoints`Establece el tamaño del papel en píxeles de pantalla o puntos de impresora.
`PrintHtmlBackgrounds``Boolean`Indica si se deben imprimir colores e imágenes de fondo desde HTML. El valor por defecto es true.
`RequestContext``RequestContexts`Solicite contexto para este render, determinando el aislamiento de ciertos recursos como las cookies.
`Timeout``Integer`Tiempo de espera en segundos. El valor por defecto es 60.
`Title``String`Metadatos de nombre y título de documento PDF, útiles para la fusión de correo y la asignación automática de nombres de archivo en las extensiones IronPDF MVC y Razor.
`ForcePaperSize``Boolean`Obliga a que el tamaño de las páginas sea exactamente el especificado mediante IronPDF.ChromePdfRenderOptions.PaperSize al cambiar el tamaño de la página después de generar un PDF a partir de HTML. Ayuda a corregir pequeños errores en el tamaño de la página al convertir HTML a PDF.
`WaitFor``WaitFor`Un objeto envoltorio que contiene la configuración del mecanismo wait-for para que los usuarios esperen determinados eventos antes de la renderización. Por defecto, no esperará nada.
¿Listo para explorar más capacidades? Visita nuestra página de tutoriales: [Convertir PDF](https://ironpdf.com/tutorials/convert-pdf/)

Preguntas Frecuentes

¿Cuáles son las opciones de renderizado en la generación de PDF?

Las opciones de renderizado en IronPDF son configuraciones que controlan cómo se crean, muestran e imprimen los documentos PDF a través de la clase ChromePdfRenderer. Incluyen configuraciones para márgenes, encabezados, pies de página, tamaño del papel, ejecución de JavaScript, tipos de medios CSS, elementos de formulario y tablas de contenido, lo que permite una personalización precisa de la salida PDF desde HTML, CSS y otras fuentes de contenido.

¿Cómo se aplican las opciones de representación a un PDF?

Para aplicar las opciones de renderizado en IronPDF: 1) Instale IronPDF a través de NuGet, 2) Cree una instancia de ChromePdfRenderer, 3) Configure los ajustes a través de la propiedad RenderingOptions, 4) Renderice su contenido (HTML, Markdown, etc.) a PDF, y 5) Guarde el PDF resultante. Puede configurar varias opciones en una sola línea, como márgenes, tipo de medio CSS, encabezados y valores de tiempo de espera.

¿Puedo utilizar las opciones de renderizado con contenido que no sea HTML?

Sí, aunque muchas propiedades de las opciones de renderizado están diseñadas para la conversión de HTML a PDF, también funcionan con otros tipos de conversión de PDF en IronPDF. Puede aplicar opciones de renderizado al convertir Markdown a PDF u otros formatos compatibles, lo que le proporciona el mismo nivel de control sobre el resultado final en PDF, independientemente del tipo de contenido de origen.

¿Qué es PaperFit y cómo funciona?

PaperFit es un gestor dentro de la clase ChromePdfRenderer de IronPDF que controla el diseño del contenido en las páginas PDF. Ofrece diferentes estilos de renderizado, incluidos diseños CSS3 con capacidad de respuesta u opciones de alimentación continua, lo que ayuda a garantizar que el contenido se ajuste correctamente a las páginas PDF según sus requisitos específicos.

¿Por qué debo configurar las opciones de representación de mis PDF?

La configuración de las opciones de renderizado en IronPDF garantiza que sus PDF se generen con las especificaciones exactas necesarias para documentos profesionales. Esto incluye tamaños de papel personalizados, márgenes específicos, encabezados y pies de página, o JavaScript habilitado para contenido dinámico. Este nivel de control es crucial a la hora de crear informes, facturas o cualquier documento que requiera un formato preciso.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 17,012,929 | Versión: 2025.12 recién lanzado