大規模PDFをチャンクごとに処理してヘッダーとフッターを追加する方法

Curtis Chau
Curtis Chau
更新日: 2026年8月21日

非常に大きなPDFに1回でヘッダーとフッターを追加するのは時間がかかることがあります。 ドキュメントを固定サイズのページチャンクで処理し、その後結果をマージすることで、レンダリング時間を短縮しつつ、全体のページ番号を継続的に保持します。

解決策

1. ページインデックスをバッチに分割

チャンクサイズを選び、ドキュメントのページインデックスを固定サイズのバッチにグループ化します(以下では300ページずつ)。 これにより、各レンダリングパスが処理するページ数が決定されます。

2. 各バッチを個別のドキュメントにコピー

現在のバッチのページをCopyPagesを使って抽出し、各チャンクが独立したPdfDocumentになるようにします。

3. 連続番号でヘッダーとフッターを追加する

FirstPageNumberをチャンクの開始ページに設定します。 これにより、各チャンクで1から再開せずに、全体のドキュメントでページ番号が継続されます。

4. 各チャンクを保存し、処分

各チャンクを一時ファイルに書き込み、破棄します。 次のバッチの前にチャンクを解放することで、メモリを管理します。

5. チャンクをマージして最終的なPDFを保存する

一時ファイルを再度開き、AppendPdfで順番に追加して結果を保存し、その後一時ファイルを削除します。

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は各バッチの最初のインデックスから派生するので、FirstPageNumberは前のチャンクの終わりから正確に続きます。

注意事項と制限

  • 連続番号: FirstPageNumberがチャンク間でページ番号を継続させます。 これがなければ、各チャンクはページ1から再開します。
  • チャンクサイズは調整可能: 300は開始点です; チャンク化の効果が現れるサイズは、作業負荷によって異なります。
  • マージは追加パスを必要とします: 合計時間はチャンクごとのレンダリングと最終マージの合計です。
  • 非常に大きなジョブ: マージ中に定期的にガベージコレクションを強制し、ブラウザプール(BrowserPool.MaxIdleTabs, MaxDynamicHFPagesPerBatch)を調整することで、メモリを管理しやすくなります。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 22,198,312バージョン:2026.11ちょうどリリースされました