En-têtes et pieds de page sur des PDF volumineux par morceaux

Curtis Chau
Curtis Chau
Mis à jour : 21 août 2026

Ajouter des en-têtes et des pieds de page à un PDF très volumineux en un seul passage peut être lent. Traitez le document par morceaux de pages de taille fixe, puis fusionnez les résultats, pour réduire le temps de rendu tout en gardant une numérotation continue des pages sur l'ensemble du document.

Solution

1. Diviser les index de pages en lots

Choisissez une taille de morceau et regroupez les index de pages du document en lots de taille fixe (300 pages chacune ci-dessous). Cela détermine combien de pages chaque passage de rendu doit gérer.

2. Copiez chaque lot dans son propre document

Extrayez les pages pour le lot actuel avec CopyPages afin que chaque morceau soit un PdfDocument indépendant.

3. Ajoutez des en-têtes et pieds de page avec une numérotation continue

Définir FirstPageNumber à la page de début du morceau. Cela maintient la numérotation des pages sur l'ensemble du document au lieu de recommencer à 1 dans chaque morceau.

4. Enregistrez chaque bloc et disposez-le

Écrivez chaque morceau dans un fichier temporaire et éliminez-le. Libérer le morceau avant le lot suivant permet de garder la mémoire sous contrôle.

5. Fusionner les morceaux et enregistrer le PDF final

Rouvrez les fichiers temporaires, ajoutez-les dans l'ordre avec AppendPdf, enregistrez le résultat, puis supprimez les fichiers temporaires.

using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
string headerHtml = "<div style='font-size:10px;'>Header</div>";
string footerHtml = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>";
int chunkSize = 300;
var pageChunks = Enumerable.Range(0, pdf.PageCount)
    .GroupBy(i => i / chunkSize)
    .Select(g => g.ToArray())
    .ToList();
var tempFiles = new List<string>();
foreach (var indexes in pageChunks)
{
    var chunkPdf = pdf.CopyPages(indexes);
    int globalStartPage = indexes.First() + 1;
    chunkPdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
    {
        FirstPageNumber = globalStartPage,          // keeps numbering continuous
        HtmlHeader = new HtmlHeaderFooter { HtmlFragment = headerHtml, MaxHeight = 40 },
        HtmlFooter = new HtmlHeaderFooter { HtmlFragment = footerHtml, MaxHeight = 40 }
    });
    string tempFile = Path.GetTempFileName() + ".pdf";
    chunkPdf.SaveAs(tempFile);
    chunkPdf.Dispose();
    tempFiles.Add(tempFile);
}
// Merge the chunks back into one document.
var finalPdf = new PdfDocument(tempFiles.First());
foreach (var file in tempFiles.Skip(1))
{
    using var part = new PdfDocument(file);
    finalPdf.AppendPdf(part);
}
finalPdf.SaveAs("output.pdf");
finalPdf.Dispose();
// Clean up temp files.
foreach (var file in tempFiles)
    File.Delete(file);

globalStartPage est dérivé du premier index de chaque lot, donc FirstPageNumber reprend exactement là où le morceau précédent s'est arrêté.

Notes et Limitations

  • Numérotation continue : FirstPageNumber est ce qui porte la numérotation des pages à travers les morceaux. Sans cela, chaque morceau repart à la page 1.
  • La taille du morceau est ajustable : 300 est un point de départ ; la taille à laquelle le morcellement commence à porter ses fruits dépend de la charge de travail.
  • La fusion ajoute un passage : le temps total est la somme du rendu par morceau plus la fusion finale.
  • Travaux très volumineux : forcer périodiquement la collecte de déchets pendant la fusion et ajuster le pool de navigateurs (BrowserPool.MaxIdleTabs, MaxDynamicHFPagesPerBatch) peut aider à garder la mémoire sous contrôle.

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 et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 22,198,312Version :2026.11tout juste publié