1. IronPDF
  2. Comment faire
  3. Ajouter des en-têtes et des pieds de page

Comment ajouter des en-têtes et des pieds de page

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

par Jordi Bardia

Vous avez besoin d'inclure des numéros de page, un logo d'entreprise ou une date en haut ou en bas de chaque page d'un document PDF ? Avec les en-têtes et les pieds de page, vous pouvez! Avec IronPDF, il est très simple d'appliquer des en-têtes et des pieds de page aux PDF dans votre projet C#.

Commencez avec IronPDF

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer

Comment ajouter des en-têtes et des pieds de page

  1. Télécharger la bibliothèque C# pour ajouter des en-têtes et des pieds de page
  2. Charger un PDF existant ou en créer un nouveau
  3. Utiliser le Ajouter des en-têtes de texte et Ajouter des pieds de page des méthodes pour ajouter des en-têtes et des pieds de page de texte
  4. Utiliser le AddHtmlHeaders et AddHtmlFooters méthodes pour ajouter des en-têtes et des pieds de page HTML
  5. Ajouter des en-têtes et des pieds de page au moment du rendu en configurant les options de rendu

Ajouter un texte Exemple d'en-tête/pied de page

Pour créer un en-tête/pied de page à partir de texte uniquement, instanciez un objet TextHeaderFooter, ajoutez le texte souhaité et ajoutez l'objet à votre PDF.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-add-textheaderfooter.cs
using IronPdf;

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

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Vous pouvez également ajouter directement un en-tête/pied de page en utilisant les options de rendu du moteur de rendu. Cela ajoutera l'en-tête et le pied de page du texte pendant le processus de rendu.

: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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Personnaliser les propriétés du texte et des séparateurs

Dans la classe TextHeaderFooter, vous avez la possibilité de définir le texte pour les positions gauche, centrale et droite. En outre, vous pouvez personnaliser le type de police et la taille du texte et ajouter un séparateur d'une couleur personnalisée en configurant les propriétés correspondantes.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-textheaderfooter-options.cs
using IronPdf;
using IronPdf.Font;
using IronSoftware.Drawing;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "Center text", // Set the text in the center
    LeftText = "Left text", // Set left-hand side text
    RightText = "Right text", // Set right-hand side text
    Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic, // Set font
    FontSize = 16, // Set font size
    DrawDividerLine = true, // Draw Divider Line
    DrawDividerLineColor = Color.Red, // Set color of divider line
};
Imports IronPdf
Imports IronPdf.Font
Imports IronSoftware.Drawing

' Create text header
Private textHeader As New TextHeaderFooter With {
	.CenterText = "Center text",
	.LeftText = "Left text",
	.RightText = "Right text",
	.Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic,
	.FontSize = 16,
	.DrawDividerLine = True,
	.DrawDividerLineColor = Color.Red
}
VB   C#

En-tête du texte de sortie

En-tête de texte

Vous pouvez voir quels types de polices sont disponibles par défaut dans la rubrique Référence de l'API IronPDF.

Définir les marges pour l'en-tête et le pied de page du texte

Par défaut, l'en-tête et le pied de page du texte dans IronPDF ont des marges prédéfinies. Si vous voulez que l'en-tête de texte couvre toute la largeur du document PDF, vous pouvez spécifier des valeurs de marge de 0. Ceci peut être réalisé soit en définissant les marges directement dans les fonctions AddTextHeaders et AddTextFooters, soit à travers les RenderingOptions dans ChromePdfRenderer.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-textheaderfooter-margins.cs
using IronPdf;

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

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

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

pdf.AddTextHeaders(header, 35, 30, 25); // Left Margin = 35, Right Margin  = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25); // Margin values are in mm
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Si vous ajoutez des valeurs de marge dans les RenderingOptions de ChromePdfRenderer, ces marges seront également appliquées à l'en-tête et au pied de page.

: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;
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;

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

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Dimensionnement dynamique des marges

La marge statique pose un problème lorsque le contenu de l'en-tête varie 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 de l'en-tête et du pied de page. Par conséquent, nous avons mis en place une fonction de dimensionnement dynamique des marges dans laquelle la hauteur de l'en-tête et du pied de page s'ajuste dynamiquement en fonction du contenu, et le code HTML principal se repositionne en conséquence. Veuillez utiliser le code ci-dessous pour vérifier la 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");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")
pdf.SaveAs("dynamicHeaderSize.pdf")
VB   C#

Métadonnées dans l'en-tête/le pied de page du texte

Vous pouvez facilement ajouter des métadonnées telles que les numéros de page, la date et le titre d'un PDF, en incorporant des chaînes de caractères de remplacement dans votre texte. Voici toutes les options de métadonnées disponibles :

  • {page}: Numéro de la page actuelle.
  • {nombre total de pages}: Nombre total de pages.
  • {url}: URL web à partir de laquelle le document PDF a été rendu.
  • {date}: Date actuelle.
  • {temps}: Heure actuelle.
  • {titre html}: Titre HTML spécifié dans la balise title en HTML.

  • {titre du pdf}: Titre du PDF spécifié dans les métadonnées du PDF.

    Pour en savoir plus{page} et{nombre total de pages}, veuillez consulter le siteGuide des numéros de page IronPDF guide pratique.

: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}",
};
Imports IronPdf

' Create header and footer
Private textHeader As New TextHeaderFooter With {
	.CenterText = "{page} of {total-pages}",
	.LeftText = "Today's date: {date}",
	.RightText = "The time: {time}"
}

Private textFooter As New TextHeaderFooter With {
	.CenterText = "Current URL: {url}",
	.LeftText = "Title of the HTML: {html-title}",
	.RightText = "Title of the PDF: {pdf-title}"
}
VB   C#

Ajouter un exemple d'en-tête/pied de page HTML

Vous pouvez personnaliser davantage votre en-tête/pied de page en utilisant HTML et CSS. Pour créer un en-tête/pied de page HTML, utilisez la classe HtmlHeaderFooter. Si vous souhaitez conserver les styles CSS d'une feuille de style CSS, assurez-vous de définir LoadStylesAndCSSFromMainHtmlDocument = true dans les propriétés de la classe.

: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);
Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)
VB   C#

Comme pour l'en-tête et le pied de page, les méthodes AddHtmlHeaders et AddHtmlFooters présentées ci-dessus 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 que l'ensemble du contenu s'étende sans aucune marge, réglez les marges de la fonction de surcharge sur 0.

: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);
' Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0)
pdf.AddHtmlFooters(footer, 0, 0, 0)
VB   C#

L'ajout d'en-têtes et de pieds de page peut également se faire directement dans les options de rendu du moteur de rendu. Cela ajoutera l'en-tête et le pied de page HTML pendant le processus de rendu.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-render-with-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
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create header and footer and add to rendering options
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = headerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = footerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

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

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer
Private renderer As New ChromePdfRenderer()

' Create header and footer and add to rendering options
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Render PDF with header and footer
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
VB   C#

Choisir entre des en-têtes/pieds de page textuels et des en-têtes/pieds de page HTML

Pour choisir entre les en-têtes/pieds de page texte et HTML, il faut tenir compte des compromis possibles. Si vous privilégiez un rendu plus rapide du PDF, optez pour des en-têtes/pieds de page textuels. En revanche, si la personnalisation et le style sont essentiels, optez pour des en-têtes/pieds de page en HTML. La différence de temps de rendu entre les en-têtes/pieds de page texte et HTML n'est pas trop importante lorsque les en-têtes/pieds de page HTML ne contiennent pas beaucoup de contenu. Toutefois, il augmente avec la taille et le nombre de ressources dans les en-têtes/pieds de page HTML.

Jordi related to Choisir entre des en-têtes/pieds de page textuels et des en-têtes/pieds de page HTML

Jordi Bardia

Ingénieur logiciel

Jordi maîtrise parfaitement Python, C# et C++. Lorsqu'il ne met pas à profit ses compétences chez Iron Software, il se consacre à la programmation de jeux. Partageant des responsabilités en matière de tests de produits, de développement de produits et de recherche, Jordi apporte une valeur ajoutée considérable à l'amélioration continue des produits. Cette expérience variée le stimule et l'engage, et il dit que c'est l'un des aspects qu'il préfère dans son travail chez Iron Software. Jordi a grandi à Miami, en Floride, et a étudié l'informatique et les statistiques à l'université de Floride.