大規模PDFをチャンクごとに処理してヘッダーとフッターを追加する方法
非常に大きな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);Imports IronPdf
Imports System.IO
Imports System.Linq
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim headerHtml As String = "<div style='font-size:10px;'>Header</div>"
Dim footerHtml As String = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>"
Dim chunkSize As Integer = 300
Dim pageChunks = Enumerable.Range(0, pdf.PageCount).GroupBy(Function(i) i \ chunkSize).[Select](Function(g) g.ToArray()).ToList()
Dim tempFiles = New List(Of String)()
For Each indexes In pageChunks
Dim chunkPdf = pdf.CopyPages(indexes)
Dim globalStartPage As Integer = indexes.First() + 1
chunkPdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.FirstPageNumber = globalStartPage,
.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = headerHtml, .MaxHeight = 40},
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = footerHtml, .MaxHeight = 40}
})
Dim tempFile As String = Path.GetTempFileName() & ".pdf"
chunkPdf.SaveAs(tempFile)
chunkPdf.Dispose()
tempFiles.Add(tempFile)
Next
' Merge the chunks back into one document.
Dim finalPdf = New PdfDocument(tempFiles.First())
For Each file In tempFiles.Skip(1)
Using part As New PdfDocument(file)
finalPdf.AppendPdf(part)
End Using
Next
finalPdf.SaveAs("output.pdf")
finalPdf.Dispose()
' Clean up temp files.
For Each file In tempFiles
File.Delete(file)
NextImports IronPdf
Imports System.IO
Imports System.Linq
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim headerHtml As String = "<div style='font-size:10px;'>Header</div>"
Dim footerHtml As String = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>"
Dim chunkSize As Integer = 300
Dim pageChunks = Enumerable.Range(0, pdf.PageCount).GroupBy(Function(i) i \ chunkSize).[Select](Function(g) g.ToArray()).ToList()
Dim tempFiles = New List(Of String)()
For Each indexes In pageChunks
Dim chunkPdf = pdf.CopyPages(indexes)
Dim globalStartPage As Integer = indexes.First() + 1
chunkPdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.FirstPageNumber = globalStartPage,
.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = headerHtml, .MaxHeight = 40},
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = footerHtml, .MaxHeight = 40}
})
Dim tempFile As String = Path.GetTempFileName() & ".pdf"
chunkPdf.SaveAs(tempFile)
chunkPdf.Dispose()
tempFiles.Add(tempFile)
Next
' Merge the chunks back into one document.
Dim finalPdf = New PdfDocument(tempFiles.First())
For Each file In tempFiles.Skip(1)
Using part As New PdfDocument(file)
finalPdf.AppendPdf(part)
End Using
Next
finalPdf.SaveAs("output.pdf")
finalPdf.Dispose()
' Clean up temp files.
For Each file In tempFiles
File.Delete(file)
NextglobalStartPageは各バッチの最初のインデックスから派生するので、FirstPageNumberは前のチャンクの終わりから正確に続きます。
注意事項と制限
- 連続番号:
FirstPageNumberがチャンク間でページ番号を継続させます。 これがなければ、各チャンクはページ1から再開します。 - チャンクサイズは調整可能: 300は開始点です; チャンク化の効果が現れるサイズは、作業負荷によって異なります。
- マージは追加パスを必要とします: 合計時間はチャンクごとのレンダリングと最終マージの合計です。
- 非常に大きなジョブ: マージ中に定期的にガベージコレクションを強制し、ブラウザプール(
BrowserPool.MaxIdleTabs,MaxDynamicHFPagesPerBatch)を調整することで、メモリを管理しやすくなります。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。