Cómo utilizar las opciones de renderización

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

por Chaknith Bin

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.


Biblioteca NuGet C# para PDF

Instalar con NuGet

Install-Package IronPdf
o
Java PDF JAR

Descargar DLL

Descargar DLL

Instalar manualmente en su proyecto

Biblioteca NuGet C# para PDF

Instalar con NuGet

Install-Package IronPdf
o
Java PDF JAR

Descargar DLL

Descargar DLL

Instalar manualmente en su proyecto

Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer

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#.

Biblioteca NuGet C# para PDF nuget.org/packages/IronPdf/
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 DLL

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")
VB   C#

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.

ClaseChromePdfRenderer
DescripciónPermite 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 / funcionesTipoDescripción
CustomCookiesDictionary<cadena, cadena>Cookies personalizadas para el renderizado HTML. Las cookies no persisten entre renderizaciones y deben configurarse cada vez.
PaperFitVirtualPaperLayoutManagerUn 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.
UseMarginsOnHeaderAndFooterUseMarginsUtilizar los valores de margen del documento principal al representar los encabezados y pies de página.
CreatePdfFormsFromHtmlboolConvierte todos los elementos de formulario HTML en formularios PDF editables. El valor por defecto es true.
CssMediaTipoPdfCssMediaTipoEnables Media="screen" CSS Styles and StyleSheets. Default value is PdfCssMediaTipo.Screen.
CustomCssUrlcadenaPermite 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 JavaScriptboolPermite ejecutar JavaScript y JSON antes de renderizar la página. Ideal para imprimir desde aplicaciones Ajax / Angular. El valor por defecto es false.
EnableMathematicalLaTexboolPermite la representación de elementos matemáticos LaTeX.
JavascriptcadenaA custom JavaScript cadena to be executed after all HTML has loaded but before PDF rendering.
JavascriptMessageListenerCadenaDelegateUn 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áginaintNú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.
TablaDeContenidosTablaDeContenidosTiposGenera una tabla de contenidos en el lugar del documento HTML donde se encuentra un elemento con id "ironpdf-toc".
Escala de grisesboolImprime un PDF en blanco y negro. El valor por defecto es false.
Cabecera de textoICabecera de textoFooterEstablece 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
HtmlHeaderHtmlHeaderFooterEstablece el contenido de la cabecera de cada página PDF como HTML. Admite la fusión de correo.
HtmlFooter
Codificación de entradaCodificaciónThe input character encoding as a cadena. Default value is Codificación.UTF8.
MarginTopdobleMargen 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.
MarginRightdobleMargen 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.
MarginBottomdobleMargen "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.
MargenIzquierdodobleMargen "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 papelPdfOrientación del papelLa orientación del papel PDF, como Vertical u Horizontal. El valor predeterminado es Vertical.
TamañoPapelPdfTamañoPapelEstablece el tamaño del papel
SetCustomTamañoPapelinCentimetersdobleEstablece el tamaño del papel in centimeters.
SetCustomTamañoPapelInInchesEstablece el tamaño del papel in inches.
SetCustomTamañoPapelinMilimetersEstablece el tamaño del papel in millimeters.
SetCustomTamañoPapelinPixelsOrPointsEstablece el tamaño del papel in screen pixels or printer points.
PrintHtmlBackgroundsBooleanooIndica si se imprimen los colores de fondo y las imágenes de HTML. El valor por defecto es true.
RequestContextRequestContextsContexto de la solicitud para este render, determinando el aislamiento de ciertos recursos como las cookies.
Tiempo de esperaEnteroTiempo de espera en segundos. El valor por defecto es 60.
TítuloCadenaPDF Document Name and Título metadata, useful for mail-merge and automatic file naming in the IronPdf MVC and Razor extensions.
ForceTamañoPapelBooleanooForce 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 enEspere enUn 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.

Chaknith Bin

Ingeniero de software

Chaknith es el Sherlock Holmes de los desarrolladores. La primera vez que se le ocurrió que podría tener futuro en la ingeniería de software fue cuando hacía retos de código por diversión. Su trabajo se centra en IronXL e IronBarcode, pero se enorgullece de ayudar a los clientes con todos los productos. Chaknith aprovecha sus conocimientos, adquiridos hablando directamente con los clientes, para ayudar a mejorar los propios productos. Sus comentarios anecdóticos van más allá de los tickets de Jira y apoyan el desarrollo de productos, la documentación y el marketing, para mejorar la experiencia general del cliente.Cuando no está en la oficina, se le puede encontrar aprendiendo sobre aprendizaje automático, codificación y senderismo.