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

Comment utiliser les options de rendu dans IronPDF avec C#

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

Les options de rendu dans IronPDF personnalisent la génération de PDF par le biais de la classe ChromePdfRenderer, en contrôlant des paramètres tels que les marges, les en-têtes, les pieds de page, la taille du papier, l'exécution JavaScript et les types de médias CSS pour créer des documents PDF formatés avec précision à partir de HTML, CSS et d'autres sources de contenu.

Démarrage rapide : appliquer les options de rendu en C#

  1. Installer IronPDF via le gestionnaire de paquets NuGet
  2. Créez une instance de ChromePdfRenderer
  3. Configurer les options de rendu à l'aide de la propriété RenderingOptions
  4. Transformez votre contenu (HTML, Markdown, etc.) en PDF
  5. Enregistrer le document PDF résultant

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

  2. Copiez et exécutez cet extrait de code.

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

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Les options de rendu dans la génération de PDF sont des paramètres qui déterminent la façon dont un document PDF est créé, affiché et imprimé. Ces options comprennent le rendu des éléments de formulaire, l'activation de JavaScript, la génération de tables des matières, l'ajout d'en-têtes et de pieds de page, l'ajustement des marges, la définition de la taille du papier, etc.

La classe ChromePdfRenderer d'IronPDF offre diverses options de rendu permettant de personnaliser la génération de PDF. Il comprend PaperFit, un gestionnaire qui contrôle la mise en page du contenu sur les pages PDF, offrant différents styles tels que des mises en page CSS3 réactives ou un flux continu. Lorsque vous travaillez avec des documents complexes, il se peut que vous deviez fusionner ou diviser des PDF après avoir appliqué des options de rendu.

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque C# pour utiliser les options de rendu
  2. Préparer les ressources HTML ou le fichier pour la conversion en PDF
  3. Instantiate the `ChromePdfRenderer` class
  4. Access the `RenderingOptions` property to configure settings
  5. Rendez le PDF dans le format souhaité

## Comment utiliser les options de rendu dans IronPDF? Bien que de nombreuses propriétés d'options de rendu soient conçues pour la conversion HTML-PDF, elles fonctionnent également avec d'autres types de conversion PDF. Rendons Markdown en PDF et configurons la sortie à l'aide des options de rendu. Pour les conversions HTML en particulier, découvrez comment convertir des fichiers HTML en PDF ou convertir des chaînes HTML en PDF. ### Pourquoi dois-je configurer les options de rendu ? La configuration des options de rendu permet de s'assurer que les PDF sont générés selon des spécifications précises : formats de papier personnalisés, marges spécifiques, en-têtes et pieds de page, ou activation de JavaScript pour le contenu dynamique. Cette maîtrise est cruciale lors de la création de nouveaux PDF pour des documents ou des rapports professionnels. ### Que se passe-t-il lorsque j'applique plusieurs options de rendu? Plusieurs options de rendu sont utilisées pour créer le fichier PDF final. Chaque option modifie un aspect spécifique du rendu, et IronPDF les applique de manière séquentielle au cours de la conversion. Par exemple, lors de la définition des marges et des en-têtes, le contenu de l'en-tête respecte les paramètres de marge à moins qu'ils ne soient remplacés par la propriété `UseMarginsOnHeaderAndFooter`. ```csharp :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ``` ### Exemple d'options de rendu avancées Cet exemple complet démontre la combinaison de plusieurs options de rendu pour la génération de documents professionnels. Cette approche est utile lorsque vous devez [ajouter des en-têtes et des pieds de page](https://ironpdf.com/how-to/headers-and-footers/) ou travailler avec [des formats de papier personnalisés](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"); ```
## Quelles sont les options de rendu disponibles ? Les options avancées définissent les paramètres de rendu PDF tels que les marges, l'orientation du papier, le format du papier, etc. La compréhension de ces options est utile lorsque vous devez définir des marges personnalisées ou travailler avec différents paramètres d'affichage et niveaux de zoom. ### Quelles sont les options de rendu les plus couramment utilisées ? Les options de rendu les plus couramment utilisées sont les paramètres de marge, la configuration de la taille du papier, la configuration de l'en-tête/du pied de page et l'activation de JavaScript. Ces options couvrent la plupart des besoins de personnalisation des PDF. Pour le contenu Web, les options de rendu JavaScript garantissent un rendu correct des éléments dynamiques. ### Comment choisir les bonnes options de rendu? Choisissez les options de rendu en fonction de vos besoins : utilisez les paramètres de marge pour les mises en page d'impression, activez JavaScript pour le contenu web dynamique, configurez les en-têtes/pieds de page pour les documents professionnels et ajustez la taille du papier pour des formats de sortie spécifiques. Lorsque vous travaillez avec du contenu web, tenez compte des types de médias CSS pour un rendu optimal. ### Quand dois-je utiliser les options de rendu avancées ? Utilisez les options de rendu avancées pour des fonctions spécialisées telles que l'injection CSS personnalisée, le rendu mathématique LaTeX, la sortie en niveaux de gris, ou lorsque vous travaillez avec des applications web complexes nécessitant une synchronisation spécifique de l'exécution de JavaScript. La classe WaitFor permet de contrôler avec précision les délais de rendu dans le cadre de scénarios complexes. ### Travailler avec des éléments de formulaire Lorsque le langage HTML contient des éléments de formulaire, IronPDF les convertit automatiquement en formulaires PDF interactifs : ```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"); ``` Vous trouverez ci-dessous un tableau illustrant les différentes options disponibles.
Classe ChromePdfRenderer
Description du projet Utilisé pour définir les options d'impression PDF, comme la taille du papier, le DPI, les en-têtes et les pieds de page
Propriétés / fonctions Type de texte Description du projet
`CustomCookies` `Dictionary<string, string>` Cookies personnalisés pour le rendu HTML. Les cookies ne persistent pas entre les rendus et doivent être définis à chaque fois.
`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` Utilisez les valeurs de marge du document principal lors du rendu des en-têtes et des pieds de page.
`CreatePdfFormsFromHtml` `bool` Transforme tous les éléments de formulaire HTML en formulaires PDF éditables. La valeur par défaut est true.
`CssMediaType de texte` `PdfCssMediaType de texte` Active les styles et feuilles de style CSS Media="screen". La valeur par défaut est PdfCssMediaType de texte.Screen.
`CustomCssUrl` `string` Permet d'appliquer une feuille de style CSS personnalisée au code HTML avant le rendu. Il peut s'agir d'un chemin de fichier local ou d'une URL distante. Uniquement applicable lors du rendu de HTML en PDF.
`EnableJavaScript` `bool` Permet d'exécuter JavaScript et JSON avant le rendu de la page. Idéal pour l'impression à partir d'applications Ajax / Angular. La valeur par défaut est false.
`EnableMathematicalLaTex` `bool` Permet le rendu des éléments mathématiques LaTeX.
`Javascript` `string` Une chaîne JavaScript personnalisée à exécuter après le chargement de tout le HTML, mais avant le rendu du PDF.
`JavascriptMessageListener` `StringDelegate` Une méthode de rappel à invoquer chaque fois qu'un message de la console JavaScript du navigateur est disponible.
`FirstPageNumber` `int` Numéro de la première page à utiliser dans les en-têtes et pieds de page du PDF. La valeur par défaut est 1.
`TableOfContents` `TableOfContentsType de textes` Génère une table des matières à l'emplacement du document HTML où se trouve un élément dont l'id est "IronPdf-toc".
`GrayScale` `bool` Produit un PDF en noir et blanc. La valeur par défaut est false.
`TextHeader` `ITextHeaderFooter` Définit le contenu du pied de page de chaque page PDF en tant que texte, en prenant en charge la fusion de courriers électroniques et en transformant automatiquement les URL en hyperliens.
`TextFooter`
`HtmlHeader` `HtmlHeaderFooter` Définit le contenu de l'en-tête de chaque page PDF en HTML. Prend en charge la fusion de courriers électroniques.
`HtmlFooter`
`InputEncoding` `Encoding` L'encodage des caractères d'entrée sous forme de chaîne. La valeur par défaut est Encoding.UTF8.
`MarginTop` `double` Marge supérieure "papier" du PDF en millimètres. La valeur est fixée à zéro pour les applications d'impression commerciale et sans bordure. La valeur par défaut est 25.
`MarginRight` `double` Marge "papier" droite du PDF en millimètres. La valeur zéro est utilisée pour les applications d'impression sans bordure et les applications d'impression commerciale. La valeur par défaut est 25.
`MarginBottom` `double` Marge "papier" inférieure du PDF en millimètres. La valeur est fixée à zéro pour les applications d'impression commerciale et sans bordure. La valeur par défaut est 25.
`MarginLeft` `double` Marge "papier" gauche du PDF en millimètres. La valeur est fixée à zéro pour les applications d'impression commerciale et sans bordure. La valeur par défaut est 25.
`PaperOrientation` `PdfPaperOrientation` L'orientation du papier PDF, par exemple Portrait ou Paysage. La valeur par défaut est Portrait.
`PaperSize` `PdfPaperSize` Définit la taille du papier
`SetCustomPaperSizeinCentimeters` `double` Définit la taille du papier en centimètres.
`SetCustomPaperSizeInInches` Définit la taille du papier en pouces.
`SetCustomPaperSizeinMilimeters` Définit la taille du papier en millimètres.
`SetCustomPaperSizeinPixelsOrPoints` Définit la taille du papier en pixels d'écran ou en points d'imprimante.
`PrintHtmlBackgrounds` `Boolean` Indique s'il faut imprimer les couleurs et les images d'arrière-plan à partir de HTML. La valeur par défaut est true.
`RequestContext` `RequestContexts` Demande de contexte pour ce rendu, déterminant l'isolation de certaines ressources telles que les cookies.
`Timeout` `Integer` Délai de rendu en secondes. La valeur par défaut est 60.
`Title` `String` Métadonnées de nom et de titre de document PDF, utiles pour la fusion de courrier et le nommage automatique des fichiers dans les extensions IronPdf MVC et Razor.
`ForcePaperSize` `Boolean` Force la taille des pages à correspondre exactement à ce qui est spécifié via IronPdf.ChromePdfRenderOptions.PaperSize en redimensionnant la page après avoir généré un PDF à partir de HTML. Aide à corriger les petites erreurs de taille de page lors de la conversion de HTML en PDF.
`WaitFor` `WaitFor` Un objet enveloppant qui contient la configuration du mécanisme wait-for permettant aux utilisateurs d'attendre certains événements avant d'effectuer le rendu. Par défaut, il n'attend rien.
Prêt à explorer d'autres possibilités ? Visitez notre page de tutoriels : [Convertir les PDF](https://ironpdf.com/tutorials/convert-pdf/)

Questions Fréquemment Posées

Quelles sont les options de rendu dans la génération de PDF ?

Les options de rendu dans IronPDF sont des paramètres qui contrôlent la façon dont les documents PDF sont créés, affichés et imprimés par l'intermédiaire de la classe ChromePdfRenderer. Elles comprennent des configurations pour les marges, les en-têtes, les pieds de page, la taille du papier, l'exécution JavaScript, les types de médias CSS, les éléments de formulaire et les tables des matières, ce qui permet une personnalisation précise de la sortie PDF à partir de HTML, CSS et d'autres sources de contenu.

Comment appliquer des options de rendu à un PDF ?

Pour appliquer les options de rendu dans IronPDF : 1) Installez IronPDF via NuGet, 2) Créez une instance de ChromePdfRenderer, 3) Configurez les paramètres via la propriété RenderingOptions, 4) Rendez votre contenu (HTML, Markdown, etc.) en PDF, et 5) Enregistrez le PDF résultant. Vous pouvez définir plusieurs options sur une seule ligne, telles que les marges, le type de média CSS, les en-têtes et les valeurs de délai d'attente.

Puis-je utiliser les options de rendu avec du contenu non HTML ?

Oui, bien que de nombreuses propriétés d'options de rendu soient conçues pour la conversion de HTML en PDF, elles fonctionnent également avec d'autres types de conversion PDF dans IronPDF. Vous pouvez appliquer des options de rendu lors de la conversion de Markdown en PDF ou dans d'autres formats pris en charge, ce qui vous donne le même niveau de contrôle sur la sortie finale du PDF, quel que soit le type de contenu source.

Qu'est-ce que PaperFit et comment fonctionne-t-il ?

PaperFit est un gestionnaire au sein de la classe IronPdf's ChromePdfRenderer qui contrôle la mise en page du contenu sur les pages PDF. Il propose différents styles de rendu, y compris des mises en page CSS3 réactives ou des options d'alimentation continue, ce qui permet de s'assurer que votre contenu s'adapte correctement aux pages PDF en fonction de vos exigences spécifiques.

Pourquoi dois-je configurer les options de rendu pour mes PDF ?

La configuration des options de rendu dans IronPDF permet de s'assurer que vos PDF sont générés avec les spécifications exactes requises pour les documents professionnels. Il peut s'agir de formats de papier personnalisés, de marges spécifiques, d'en-têtes et de pieds de page, ou de l'activation de JavaScript pour un contenu dynamique. Ce niveau de contrôle est crucial lors de la création de rapports, de factures ou de tout autre document nécessitant un formatage précis.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir