Cómo utilizar las opciones de renderización
Las opciones de renderizado en la generación de PDF se refieren a los ajustes y configuraciones que determinan cómo se crea, muestra e imprime un documento PDF. Estas opciones pueden incluir una amplia gama de configuraciones, como renderizar elementos de campos de formulario, habilitar JavaScript, generar una tabla de contenidos, añadir encabezados y pies de página, ajustar márgenes, establecer el tamaño de papel del PDF, y más.
La clase ChromePdfRenderer en IronPDF ofrece varias opciones de renderizado que permiten a los usuarios personalizar cómo se generan los PDFs. Incluye PaperFit, un gestor que controla cómo se organiza el contenido en las páginas PDF, ofreciendo diferentes estilos de diseño como diseños responsivos CSS3 o alimentación continua.
Comience con IronPDF
Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.
Cómo utilizar las opciones de renderización
- Descarga la biblioteca de C# para usar opciones de renderizado
- Preparar los activos HTML o el archivo para convertirlo en un documento PDF.
- Instanciar el ChromePdfRenderer clase para renderizar el PDF
- Acceder a la RenderingOptions propiedad directamente para configurar sus ajustes
- Renderiza el PDF en el formato deseado.
Ejemplo de Opciones de Renderizado
A pesar de que muchas propiedades de opciones de renderizado están específicamente diseñadas para la conversión de HTML a PDF, también pueden ser utilizadas en otros tipos de conversiones de PDF. Vamos a renderizar la sintaxis de Markdown a PDF y usar las opciones de renderizado para configurar la salida del PDF.
:path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs
using IronPdf;
// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
HtmlFragment = "<h1>Header Content</h1>"
};
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);
renderer.RenderingOptions.MarginTop = 0;
// Markdown string
string md = "This is some **bold** and *italic* text.";
// Render from markdown string
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);
// Save the PDF
pdf.SaveAs("renderingOptions.pdf");
Imports IronPdf
' Instantiate Renderer
Private renderer As New ChromePdfRenderer()
' Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = "<h1>Header Content</h1>"}
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150)
renderer.RenderingOptions.MarginTop = 0
' Markdown string
Dim md As String = "This is some **bold** and *italic* text."
' Render from markdown string
Dim pdf As PdfDocument = renderer.RenderMarkdownStringAsPdf(md)
' Save the PDF
pdf.SaveAs("renderingOptions.pdf")
Todas las opciones de renderizado
Tenemos algunas opciones avanzadas que definen las opciones de renderizado del PDF, como el ajuste de los márgenes,
orientación del papel, tamaño del papel, etc.
A continuación encontrará un cuadro que ilustra las distintas opciones.
Clase | ChromePdfRenderer | |
---|---|---|
Descripción | Permite definir las opciones de impresión del PDF, como el tamaño del papel, los PPP, los encabezados y los pies de página. | |
Propiedades / funciones | Tipo | Descripción |
CustomCookies | Dictionary<cadena, cadena> | Cookies personalizadas para el renderizado HTML. Las cookies no persisten entre renderizaciones y deben configurarse cada vez. |
PaperFit | VirtualPaperLayoutManager | Un gestor para configurar diseños de papel virtual, controlando cómo se presentará el contenido en las páginas de "papel" PDF. Incluye opciones para Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups. |
UseMarginsOnHeaderAndFooter | UseMargins | Utilizar los valores de margen del documento principal al representar 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. |
CssMediaType | PdfCssMediaType | Habilita los estilos CSS y las hojas de estilo Media="screen". El valor por defecto es PdfCssMediaType.Screen. |
CustomCssUrl | cadena | Permite aplicar una hoja de estilo CSS personalizada al HTML antes de la visualización. Puede ser una ruta de archivo local o una URL remota. Sólo aplicable al convertir HTML a PDF. |
Activar JavaScript | 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 | cadena | 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. |
NúmeroPrimeraPágina | int | Número de la primera página que se utilizará en los encabezados y pies de página del PDF. El valor por defecto es 1. |
TablaDeContenidos | TableOfContentsTypes | Genera una tabla de contenidos en el lugar del documento HTML donde se encuentra un elemento con id "ironpdf-toc". |
Escala de grises | bool | Imprime un PDF en blanco y negro. El valor por defecto es false. |
Cabecera de texto | ITextHeaderFooter | Establece el contenido del pie de página de cada página PDF como texto, admite la fusión de correo y convierte automáticamente las URL en hipervínculos. |
Pie de texto | ||
HtmlHeader | HtmlHeaderFooter | Establece el contenido de la cabecera de cada página PDF como HTML. Admite la fusión de correo. |
HtmlFooter | ||
Codificación de entrada | Codificación | La codificación de caracteres de entrada como cadena. El valor por defecto es Encoding.UTF8. |
MarginTop | doble | Margen superior del PDF "papel" en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25. |
MarginRight | doble | Margen derecho del PDF "papel" en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25. |
MarginBottom | doble | Margen "papel" inferior del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25. |
MargenIzquierdo | doble | Margen "papel" izquierdo del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25. |
Orientación del papel | PdfPaperOrientation | La orientación del papel PDF, como Vertical u Horizontal. El valor predeterminado es Vertical. |
TamañoPapel | PdfPaperSize | Establece el tamaño del papel |
SetCustomPaperSizeinCentimeters | doble | 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. | |
SetCustomPaperSizeenPixelsOrPoints | Establece el tamaño del papel en píxeles de pantalla o puntos de impresora. | |
PrintHtmlBackgrounds | Booleano | Indica si se imprimen los colores de fondo y las imágenes de HTML. El valor por defecto es true. |
RequestContext | RequestContexts | Contexto de la solicitud para este render, determinando el aislamiento de ciertos recursos como las cookies. |
Tiempo de espera | Entero | Tiempo de espera en segundos. El valor por defecto es 60. |
Título | Cadena | 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. |
ForzarTamañoDePapel | Booleano | Fuerza que los tamaños de página sean exactamente los especificados 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 página al renderizar HTML a PDF. |
Espere en | Espere en | Un objeto envoltorio que contiene la configuración del mecanismo wait-for para que los usuarios esperen ciertos eventos antes de renderizar. Por defecto, no esperará nada. |