Ajouter des en-têtes et des pieds de page dans un PDF en utilisant C# ; et IronPDF

Comment ajouter des en-têtes/pieds de page lors du rendu ?

Vous pouvez également ajouter directement un en-tête/pied de page à l'aide des RenderingOptions du moteur de rendu. Cette fonction ajoute l'en-tête et le pied de page du texte pendant le processus de rendu, ce qui est plus efficace que de les ajouter après la création du PDF. Cette approche est recommandée lorsque vous connaissez à l'avance le contenu de l'en-tête et du pied de page, car elle réduit le temps de traitement et garantit un formatage cohérent dès le départ.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-render-with-textheaderfooter.cs

using IronPdf;

// Instantiate renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create header and add to rendering options
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};


// Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Render PDF with header and footer
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
pdf.SaveAs("renderWithTextHeaderFooter.pdf");

À quoi ressemble l'en-tête de texte personnalisé?

Quelles sont les polices disponibles par défaut ?

Vous pouvez voir quels types de polices sont disponibles par défaut dans la Référence API IronPDF. IronPDF prend en charge un large éventail de polices standard, notamment Arial, Times New Roman, Helvetica, Courier et leurs variantes. Si vous avez besoin de polices personnalisées, apprenez-en plus sur la gestion des polices dans IronPDF.

Comment appliquer des marges par le biais des options de rendu?

Si vous ajoutez des valeurs de marge dans les RenderingOptions de ChromePdfRenderer, ces marges s'appliqueront également à l'en-tête et au pied de page. Cette approche offre un moyen centralisé de gérer les marges sur l'ensemble du document, y compris les en-têtes, les pieds de page et le contenu principal. Pour une personnalisation plus poussée des marges, consultez notre guide sur la définition de marges personnalisées.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-rendering-options-margins.cs

using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();

TextHeaderFooter header = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

TextHeaderFooter footer = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Margin values are in mm
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Add header and footer to renderer
renderer.RenderingOptions.TextHeader = header;
renderer.RenderingOptions.TextFooter = footer;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

Pourquoi devrais-je éviter UseMarginsOnHeaderAndFooter?

La propriété UseMarginsOnHeaderAndFooter sur RenderingOptions n'est pas adaptée à ce cas d'utilisation. Elle applique les mêmes valeurs de marge à l'en-tête, au pied de page et au contenu principal, ce qui peut amener l'en-tête à chevaucher le corps du document. Cette propriété est principalement destinée à l'application d'en-têtes et de pieds de page sur les PDFs existants en utilisant la méthode AddTextHeadersAndFooters. Pour un meilleur contrôle de la mise en page, envisagez d'utiliser des sauts de page pour gérer le flux de contenu.

Qu'est-ce que le dimensionnement dynamique des marges ?

Les marges statiques posaient un problème lorsque le contenu des en-têtes variait d'un document à l'autre. Des ajustements ont été nécessaires non seulement pour les marges de l'en-tête et du pied de page, mais aussi pour la marge principale du code HTML afin de tenir compte des différentes tailles d'en-tête et de pied de page. Par conséquent, nous avons mis en place une fonction de dimensionnement dynamique des marges qui permet d'ajuster dynamiquement la hauteur de l'en-tête et du pied de page en fonction du contenu, et de repositionner le code HTML principal en conséquence. Cette fonctionnalité est particulièrement utile lorsque l'on travaille avec des mises en page CSS réactives. Utilisez le code ci-dessous pour essayer cette fonctionnalité :

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-dynamic-marigns.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
                    <h1>Example header</h1> <br>
                    <p>Header content</p>
                    </div>",
    // Enable the dynamic height feature
    MaxHeight = HtmlHeaderFooter.FragmentHeight,
};

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");
pdf.SaveAs("dynamicHeaderSize.pdf");

Quels caractères génériques dois-je utiliser le plus souvent ?

Pour en savoir plus sur {page} et {total-pages}, consultez le Guide des numéros de page IronPdf. Ces espaces réservés sont les plus couramment utilisés car ils fournissent des informations de navigation essentielles. Les espaces réservés à la date et à l'heure sont particulièrement utiles pour les documents nécessitant un suivi de l'horodatage, tels que les rapports ou les factures.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-mail-merge.cs

using IronPdf;

// Create header and footer
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "{page} of {total-pages}",
    LeftText = "Today's date: {date}",
    RightText = "The time: {time}",
};

TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "Current URL: {url}",
    LeftText = "Title of the HTML: {html-title}",
    RightText = "Title of the PDF: {pdf-title}",
};

Comment contrôler les marges de l'en-tête et du pied de page HTML ?

Comme pour les en-têtes et les pieds de page, les méthodes AddHtmlHeaders et AddHtmlFooters ont des marges prédéfinies qui leur sont appliquées. Pour appliquer des marges personnalisées, utilisez une surcharge des fonctions avec les valeurs de marge spécifiées. Pour couvrir l'ensemble du contenu sans aucune marge, définissez les marges dans la fonction de surcharge sur 0. Ce niveau de contrôle est essentiel lors de la création de documents professionnels avec des exigences de mise en page spécifiques.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter-margins.cs

// Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0);
pdf.AddHtmlFooters(footer, 0, 0, 0);

Puis-je ajouter des en-têtes/pieds de page HTML pendant le rendu ?

L'ajout d'en-têtes et de pieds de page peut également être effectué directement via les RenderingOptions du moteur de rendu. Ce logiciel ajoute l'en-tête et le pied de page HTML pendant le processus de rendu, ce qui est plus efficace que le post-traitement. Cette méthode est particulièrement utile pour générer des PDF à partir de fichiers HTML ou pour convertir des URL en PDF.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter.cs

using IronPdf;

string headerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>";

string footerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>";

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create header and footer
HtmlHeaderFooter htmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = headerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = footerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

// Add to PDF
pdf.AddHtmlHeaders(htmlHeader);
pdf.AddHtmlFooters(htmlFooter);

Quelles sont les implications en termes de performances ?

Les en-têtes/pieds de page textuels s'affichent plus rapidement car ils ne nécessitent pas d'analyse HTML ni de traitement CSS. Les en-têtes/pieds de page HTML offrent une plus grande flexibilité mais nécessitent un temps de rendu supplémentaire proportionnel à leur complexité. Lorsque l'on travaille avec des documents volumineux ou des traitements par lots, la différence de performance devient plus perceptible. Pour des performances optimales dans des scénarios à fort volume, consultez notre guide sur la génération asynchrone de PDF.

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de didacticiels ici : Créer des PDF