1. IronPDF
  2. Guides pratiques
  3. Options de rendu

How to Use the Rendering Options

Chaknith Bin
Chaknith Bin
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Les options de rendu dans la génération de PDF se réfèrent aux paramètres et configurations qui déterminent comment un document PDF est créé, affiché et imprimé. Ces options peuvent inclure une large gamme de paramètres, tels que le rendu des éléments de champ de formulaire, l'activation de JavaScript, la génération d'une table des matières, l'ajout d'en-têtes et de pieds de page, l'ajustement des marges, la définition du format du papier PDF, et plus encore.

La classe ChromePdfRenderer dans IronPDF fournit diverses options de rendu permettant aux utilisateurs de personnaliser la manière dont les PDF sont générés. Elle inclut PaperFit, un gestionnaire qui contrôle comment le contenu est disposé sur les pages PDF, offrant différents styles de disposition tels que CSS3 réactifs ou flux continu.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
    .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
    .SaveAs("renderingOptions.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque C# pour utiliser les options de rendu
  2. Préparez les actifs HTML ou le fichier à convertir en document PDF
  3. Instanciez la classe ChromePdfRenderer pour rendre le PDF
  4. Accédez à la propriété RenderingOptions directement pour configurer vos paramètres
  5. Rendez le PDF dans le format désiré

## Exemple d'options de rendu Bien que de nombreuses propriétés d'options de rendu soient spécifiquement conçues pour la conversion HTML en PDF, elles peuvent également être utilisées dans d'autres types de conversions PDF. Rendons la syntaxe Markdown en PDF et utilisons les options de rendu pour configurer la sortie PDF. ```csharp :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ```
## Toutes les options de rendu Nous avons des options avancées qui définissent les options de rendu de PDF comme l'ajustement des marges, l'orientation du papier, la taille du papier, et plus encore. Ci-dessous se trouve un tableau pour illustrer les nombreuses options différentes.
ClasseChromePdfRenderer
DescriptionUtilisé pour définir les options d'impression PDF, comme la taille du papier, DPI, en-têtes et pieds de page
Propriétés / fonctionsTypeDescription
CustomCookiesDictionaryCookies personnalisés pour le rendu HTML. Les cookies ne persistent pas entre les rendus et doivent être définis à chaque fois.
PaperFitVirtualPaperLayoutManagerUn gestionnaire pour configurer les mises en page de papier virtuel, contrôlant comment le contenu sera disposé sur les "pages" papier PDF. Inclut des options pour le comportement par défaut de Chrome, Zoomed, mises en page responsive CSS3, Scale-To-Page & configurations de pages PDF de type flux continu.
UseMarginsOnHeaderAndFooterUseMarginsUtilise les valeurs de marge du document principal lors du rendu des en-têtes et pieds de page.
CreatePdfFormsFromHtmlboolTransforme tous les éléments de formulaire HTML en formulaires PDF éditables. La valeur par défaut est true.
CssMediaTypePdfCssMediaTypeActive les feuilles de style CSS Styles et StyleSheets pour Media="screen". La valeur par défaut est PdfCssMediaType.Screen.
CustomCssUrlstringPermet d'appliquer une feuille de style CSS personnalisée à HTML avant le rendu. Peut être un chemin de fichier local ou une URL distante. Applicable uniquement lors du rendu HTML en PDF.
EnableJavaScriptboolActive JavaScript et JSON pour être exécutés avant que la page ne soit rendue. Idéal pour imprimer depuis des applications Ajax / Angular. La valeur par défaut est false.
EnableMathematicalLaTexboolPermet le rendu des éléments mathématiques LaTeX.
JavascriptstringUne chaîne JavaScript personnalisée à exécuter après que tout le HTML a été chargé mais avant le rendu PDF.
JavascriptMessageListenerStringDelegateUne méthode de rappel à invoquer chaque fois qu'un message de console JavaScript de navigateur devient disponible.
FirstPageNumberintPremier numéro de page à utiliser dans les en-têtes et les pieds de page PDF. La valeur par défaut est 1.
TableOfContentsTableOfContentsTypesGénère une table des matières à l'endroit dans le document HTML où un élément est trouvé avec l'id "ironpdf-toc".
GrayScaleboolProduit un PDF en noir et blanc. La valeur par défaut est false.
TextHeaderITextHeaderFooterDéfinit le contenu du pied de page pour chaque page PDF en tant que texte, prenant en charge le 'mail-merge' et transformant automatiquement les URL en hyperliens.
TextFooter
HtmlHeaderHtmlHeaderFooterDéfinit le contenu de l'en-tête pour chaque page PDF en tant que HTML. Prend en charge le 'mail-merge'.
HtmlFooter
InputEncodingEncodingL'encodage des caractères d'entrée sous forme de chaîne. La valeur par défaut est Encoding.UTF8.
MarginTopdoubleMarge supérieure du "papier" PDF en millimètres. Définir à zéro pour des applications d'impression sans bordure et commerciales. La valeur par défaut est 25.
MarginRightdoubleMarge droite du "papier" PDF en millimètres. Définir à zéro pour des applications d'impression sans bordure et commerciales. La valeur par défaut est 25.
MarginBottomdoubleMarge inférieure du "papier" PDF en millimètres. Définir à zéro pour des applications d'impression sans bordure et commerciales. La valeur par défaut est 25.
MarginLeftdoubleMarge gauche du "papier" PDF en millimètres. Définir à zéro pour des applications d'impression sans bordure et commerciales. La valeur par défaut est 25.
PaperOrientationPdfPaperOrientationL'orientation du papier PDF, telle que Portrait ou Paysage. La valeur par défaut est Portrait.
PaperSizePdfPaperSizeDéfinit la taille du papier
SetCustomPaperSizeinCentimetersdoubleDéfinit la taille du papier en centimètres.
SetCustomPaperSizeInInchesDéfinit la taille du papier en pouces.
SetCustomPaperSizeinMilimetersDéfinit la taille du papier en millimètres.
SetCustomPaperSizeinPixelsOrPointsDéfinit la taille du papier en pixels d'écran ou points d'imprimante.
PrintHtmlBackgroundsBooleanIndique s'il faut imprimer les couleurs et les images de fond à partir du HTML. La valeur par défaut est true.
RequestContextRequestContextsContexte de demande pour ce rendu, déterminant l'isolation de certaines ressources telles que les cookies.
TimeoutIntegerDélai d'attente du rendu en secondes. La valeur par défaut est 60.
TitleStringNom du document PDF et métadonnées du titre, utiles pour le mail-merge et le nommage automatique des fichiers dans les extensions IronPdf MVC et Razor.
ForcePaperSizeBooleanForcer les tailles de page à être exactement ce qui est spécifié via IronPdf.ChromePdfRenderOptions.PaperSize en redimensionnant la page après la génération d'un PDF à partir de HTML. Aide à corriger de petites erreurs de taille de page lors du rendu HTML en PDF.
WaitForWaitForUn objet enveloppe qui contient la configuration pour le mécanisme d'attente permettant aux utilisateurs d'attendre certains événements avant le rendu. Par défaut, il n'attendra rien.
Prêt à voir ce que vous pouvez faire d'autre ? Consultez notre page de tutoriels ici : [Convertir les PDFs](https://ironpdf.com/tutorials/convert-pdf/)

Questions Fréquemment Posées

Comment puis-je optimiser le rendu des PDFs à l'aide d'IronPDF?

Pour optimiser le rendu des PDFs avec IronPDF, utilisez la propriété RenderingOptions de la classe ChromePdfRenderer. Cela vous permet de personnaliser des paramètres tels que l'exécution de JavaScript, le rendu des champs de formulaire et les tailles de papier personnalisées.

Quel est le rôle de la classe ChromePdfRenderer dans la génération de PDF?

La classe ChromePdfRenderer dans IronPDF est essentielle pour la génération de PDF, car elle offre diverses options de rendu pour personnaliser la création des PDFs. Elle prend en charge des fonctionnalités telles que l'ajustement de la taille du papier, la gestion de la mise en page et l'exécution de JavaScript.

Puis-je générer des PDFs à partir de la syntaxe Markdown avec IronPDF?

Oui, IronPDF prend en charge les options de rendu qui vous permettent de convertir la syntaxe Markdown en PDFs. Cela peut être réalisé en configurant la classe ChromePdfRenderer pour traiter l'entrée Markdown.

Comment puis-je ajuster les marges et les en-têtes dans IronPDF?

Ajustez les marges et les en-têtes dans IronPDF en utilisant la propriété RenderingOptions dans la classe ChromePdfRenderer. Cela vous permet de spécifier des marges personnalisées et d'ajouter des en-têtes et pieds de page à vos documents PDF.

Est-il possible de permettre une sortie en niveaux de gris dans le rendu PDF?

Oui, IronPDF permet une sortie en niveaux de gris en configurant la propriété RenderingOptions. Cette option aide à réduire la taille du fichier et est utile pour la génération de PDFs adaptés à l'impression.

Comment puis-je gérer les styles de mise en page du papier dans IronPDF?

Dans IronPDF, vous pouvez gérer les styles de mise en page du papier en utilisant le gestionnaire PaperFit dans la classe ChromePdfRenderer. Cela offre des options comme les mises en page CSS3 réactives et les configurations de style d'alimentation continue.

Quelles options sont disponibles pour personnaliser la taille du papier dans IronPDF?

IronPDF propose des méthodes telles que SetCustomPaperSizeinCentimeters, SetCustomPaperSizeInInches et SetCustomPaperSizeinMilimeters pour définir des tailles de papier personnalisées pour les documents PDF.

Comment puis-je incorporer du CSS personnalisé lors de la génération de PDFs?

Pour incorporer du CSS personnalisé dans la génération de PDF avec IronPDF, utilisez la propriété CustomCssUrl pour spécifier un chemin vers votre fichier CSS. Cela garantit que vos styles sont appliqués lors du processus de rendu.

IronPDF peut-il créer des formulaires PDF remplissables à partir de formulaires d'entrée HTML?

Oui, IronPDF peut créer des formulaires PDF remplissables à partir de l'entrée HTML en activant la propriété CreatePdfFormsFromHtml dans les RenderingOptions. Cette fonctionnalité est utile pour développer des PDFs interactifs.

Comment puis-je résoudre les problèmes de JavaScript dans le rendu des PDFs?

Assurez-vous que JavaScript est activé en définissant la propriété EnableJavaScript sur true dans les RenderingOptions de la classe ChromePdfRenderer. Cela permet aux scripts de s'exécuter pendant le processus de conversion en PDF.

IronPDF est-il entièrement compatible avec .NET 10 et cela affecte-t-il les options de rendu ?

Oui, IronPDF est entièrement compatible avec .NET 10, y compris au niveau des options de rendu. Le comportement du rendu, comme les marges, les types de médias CSS, l'exécution de JavaScript et le format de papier, fonctionne de la même manière sous .NET 10 que dans les versions précédentes .NET 8/9, sans configuration particulière ni activation de fonctionnalités supplémentaires.

Chaknith Bin
Chaknith Bin
  Discutez maintenant avec l'équipe d'ingénierie
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il a une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, documentation et expérience globale.
Prêt à commencer?
Nuget Téléchargements 16,154,058 | Version : 2025.11 vient de sortir