Comment ajouter des numéros de page à un PDF en utilisant C#35;

Comment ajouter des numéros de page de base à un PDF?

<TODO : Ajouter une image ici -->

En utilisant les chaînes de caractères {page} et {total-pages} avec la classe TextHeaderFooter ou HtmlHeaderFooter, vous pouvez ajouter le numéro de la page en cours et le nombre total de pages. Cette fonctionnalité est essentielle pour créer de nouveaux PDF ou convertir des documents HTML en PDF qui nécessitent une mise en forme professionnelle.

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-basic.cs

using IronPdf;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter()
{
    CenterText = "{page} of {total-pages}"
};

// Create html footer
HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

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

// Add header and footer
pdf.AddTextHeaders(textHeader);
pdf.AddHtmlFooters(htmlFooter);

pdf.SaveAs("pdfWithPageNumber.pdf");

Le PDF de sortie provenant du code ci-dessus est montré ci-dessous :

Vous pouvez également ajouter des en-têtes et des pieds de page avec des chaînes de caractères de remplacement de numéro de page directement dans les options de rendu du ChromePdfRenderer. Cette approche est utile lorsque vous travaillez avec options de rendu pour personnaliser votre sortie PDF.

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-chromerenderer.cs

using IronPdf;

// Add header and footer to rendering options
ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
{
    CenterText = "{page} of {total-pages}"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

string html = @"
    <h1>Hello World!</h1>
<div style='page-break-after: always;'/>
    <h1>2nd Page!</h1>";

// Render new PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

pdf.SaveAs("applyPageNumberWithRenderingOptions.pdf");

Lorsque vous travaillez avec des documents complexes, pensez à sauts de page et marges personnalisées pour vous assurer que les numéros de page s'affichent correctement.

Comment ajouter des numéros de page à des pages spécifiques uniquement?

<TODO : Ajouter une image ici -->

Avec IronPDF, vous pouvez contrôler l'emplacement des numéros de page. Faites-les démarrer sur une page spécifique ou appliquez-les à des groupes spécifiques tels que les pages indexées de façon homogène. Cette flexibilité est précieuse pour générer des rapports PDF ou travailler avec des documents contenant différentes sections.

Tout d'abord, préparez le document PDF pour appliquer les numéros de page :

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-preparation.cs

using IronPdf;
using System.Linq;
using System.Collections.Generic;

string multi_page_html = @"
    <p>This is the 1st Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 2nd Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 3rd Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 4th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 5th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 6th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 7th Page</p>";

// Create header
HtmlHeaderFooter header = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

// Render PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf(multi_page_html);

// Create a Page Range 0..6
var allPageIndices = Enumerable.Range(0, pdf.PageCount);

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-even-pages.cs

// Get even page indexes (resulting in odd page numbers)
var evenPageIndices = allPageIndices.Where(i => i % 2 == 0);

pdf.AddHtmlHeaders(header, 1, evenPageIndices);
pdf.SaveAs("EvenPages.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-odd-pages.cs

// Get odd page indexes (resulting in even page numbers)
var oddPageIndexes = allPageIndices.Where(i => i % 2 != 0);

pdf.AddHtmlHeaders(header, 1, oddPageIndexes);
pdf.SaveAs("OddPages.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-last-page-only.cs

// Last page only
var lastPageIndex = new List<int>() { pdf.PageCount - 1 };

pdf.AddHtmlHeaders(header, 1, lastPageIndex);
pdf.SaveAs("LastPageOnly.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-first-page-only.cs

// First page only
var firstPageIndex = new List<int>() { 0 };

pdf.AddHtmlHeaders(header, 1, firstPageIndex);
pdf.SaveAs("FirstPageOnly.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page.cs

// Skip the first page
var skipFirstPage = allPageIndices.Skip(1);

pdf.AddHtmlHeaders(header, 1, skipFirstPage);
pdf.SaveAs("SkipFirstPage.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page-and-dont-count-it.cs

// Skip the first page and start numbering the second page as page 1
var skipFirstPageAndDontCountIt = allPageIndices.Skip(1);

pdf.AddHtmlHeaders(header, 0, skipFirstPageAndDontCountIt);
pdf.SaveAs("SkipFirstPageAndDontCountIt.pdf");

Techniques avancées de numérotation des pages

Au-delà de la numérotation des pages de base, IronPDF prend en charge des scénarios avancés, notamment :

• Numérotation par section : Différents schémas de numérotation pour différentes sections du document
• Chiffres romains : Formatage personnalisé pour les pages de préface ou d'annexe
• Systèmes de numérotation multiples : Combinaison de différents styles de numérotation dans un même document
• Comptes de pages dynamiques : Mise à jour du nombre total de pages lors de l'ajout ou la copie de pages

Ces techniques sont précieuses pour la création de documents complexes tels que des manuels techniques, des articles universitaires ou des documents juridiques nécessitant des schémas de numérotation des pages sophistiqués.

Bonnes pratiques pour les numéros de page

Lorsque vous mettez en place des numéros de page dans vos PDF, tenez compte de ces pratiques :

1. <Cohérence : Maintenir un positionnement et un formatage cohérents dans l'ensemble du document
2. Lisibilité : Veiller à ce que les numéros de page soient clairement visibles et ne fassent pas double emploi avec le contenu
3. Accessibilité : Utiliser des tailles de police et des contrastes appropriés pour faciliter la lecture
4. Aspect professionnel : Adaptez le style des numéros de page à la conception générale de votre document

En suivant ces directives et en tirant parti des fonctionnalités flexibles de numérotation des pages d'IronPDF, vous pouvez créer des documents PDF professionnels et bien organisés répondant à vos exigences spécifiques.