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.
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.
Instalar con NuGet
Install-Package IronPdf
Descargar DLL
Instalar manualmente en su proyecto
Instalar con NuGet
Install-Package IronPdf
Descargar DLL
Instalar manualmente en su proyecto
Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.
Echa un vistazo IronPDF en Nuget para una instalación y despliegue rápidos. Con más de 8 millones de descargas, está transformando PDF con C#.
Install-Package IronPdf
Considere instalar el IronPDF DLL directamente. Descárguelo e instálelo manualmente para su proyecto o forma GAC: IronPdf.zip
Instalar manualmente en su proyecto
Descargar DLLEjemplo 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. |
CssMediaTipo | PdfCssMediaTipo | Enables Media="screen" CSS Styles and StyleSheets. Default value is PdfCssMediaTipo.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 | A custom JavaScript cadena to be executed after all HTML has loaded but before PDF rendering. |
JavascriptMessageListener | CadenaDelegate | 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 | TablaDeContenidosTipos | 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 | ICabecera de textoFooter | 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 | The input character encoding as a cadena. Default value is Codificación.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 | PdfOrientación del papel | La orientación del papel PDF, como Vertical u Horizontal. El valor predeterminado es Vertical. |
TamañoPapel | PdfTamañoPapel | Establece el tamaño del papel |
SetCustomTamañoPapelinCentimeters | doble | Establece el tamaño del papel in centimeters. |
SetCustomTamañoPapelInInches | Establece el tamaño del papel in inches. | |
SetCustomTamañoPapelinMilimeters | Establece el tamaño del papel in millimeters. | |
SetCustomTamañoPapelinPixelsOrPoints | Establece el tamaño del papel in screen pixels or printer points. | |
PrintHtmlBackgrounds | Booleanoo | 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 | PDF Document Name and Título metadata, useful for mail-merge and automatic file naming in the IronPdf MVC and Razor extensions. |
ForceTamañoPapel | Booleanoo | Force page sizes to be exactly what is specified via IronPdf.ChromePdfRenderOptions.TamañoPapel by resizing the page after generating a PDF from HTML. Helps correct small errors in page size when rendering HTML to 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. |