큰 PDF에서 단위로 헤더와 푸터 추가

Curtis Chau
Curtis Chau
업데이트됨: 2026년 8월 21일

매우 큰 PDF에 한 번에 헤더와 푸터를 추가하는 것은 느릴 수 있습니다. 문서를 고정 크기의 페이지 단위로 처리한 후 결과를 병합하면 페이지 번호를 문서 전체에 걸쳐 계속 유지하면서 렌더링 시간을 줄일 수 있습니다.

해결책

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)을 조정하여 메모리를 적절히 유지할 수 있습니다.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 22,198,312버전:2026.11방금 출시