ファイルサイズを増やさない画像ヘッダーまたはフッター

Curtis Chau
Curtis Chau
更新日: 2026年10月29日

Base64ロゴをPDFヘッダーまたはフッターに追加すると、出力ファイルが膨らむことがあります。これは画像が各ページに再埋め込みされるためです。 ヘッダーまたはフッターを静的な画像レイヤーと動的なテキストレイヤーに分割し、画像が一度だけ埋め込まれるようにし、ページごとのコンテンツを小さく保ちます。

解決策

1. ヘッダーまたはフッターを2つのHTMLフラグメントに分割

頻繁に変わるかどうかでコンテンツを分けます。 画像や変更されないテキストを静的フラグメントに配置し、{page}などページごとのコンテンツを動的フラグメントに配置します。 両方のフラグメントに同じテーブルのレイアウトを与え、セルの幅を一致させることで、動的テキストが静的なレイヤーの正しい位置に配置されます。

2. まず静的フラグメントを追加

AddHtmlHeadersAndFootersを静的フラグメントのみで呼び出します。 ベース64イメージは一度だけレンダリングされ、埋め込まれます。

3. 2回目のパスで動的フラグメントを追加

AddHtmlHeadersAndFootersを動的フラグメントのみで再び呼び出します。 このパスには画像が含まれないため、ページごとのコンテンツは小さく保たれます。 静的部分と動的部分を一緒にレンダリングすると、エンジンはすべてのHTMLを動的と扱い、各ページに画像を再埋め込みするため、ファイルが大きくなります。

using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
// Static layer: holds the Base64 image. The page-number cell is left empty.
string staticFooter = @"
<table style='width:100%; table-layout:fixed;'>
  <tr>
    <td style='width:20%;'>
      <img src='data:image/png;base64,iVBORw0KGg...' style='width:150px;' />
    </td>
    <td style='width:80%; text-align:right;'></td>
  </tr>
</table>";
// Dynamic layer: holds only {page}. Same layout, but no image.
string dynamicFooter = $@"
<table style='width:100%; table-layout:fixed;'>
  <tr>
    <td style='width:20%;'></td>
    <td style='width:80%; text-align:right; font-size:10px;'>Page {{page}} of {pdf.PageCount}</td>
  </tr>
</table>";
// Pass 1: add the static image footer (image embedded once).
pdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
{
    HtmlFooter = new HtmlHeaderFooter { HtmlFragment = staticFooter, MaxHeight = 40 }
});
// Pass 2: add the dynamic page-number footer (no image, stays small).
pdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
{
    HtmlFooter = new HtmlHeaderFooter { HtmlFragment = dynamicFooter, MaxHeight = 40 }
});
pdf.SaveAs("output.pdf");

最初の処理はstaticFooterでBase64画像を運びます。 2回目の処理はdynamicFooterでPage {page} of ...のみを運びます。 両方のテーブルは同一のセル幅を使用するため、ページ番号が静的レイヤー上で揃います。

4. (オプション) 外部画像またはSVGの参照

出力をさらに縮小するには、<img>タグを外部の画像ファイルに指すか、画像をBase64文字列としてインライン化する代わりにSVGを使用します。

注意事項と制限

  • レイアウトを一致させる必要: 両方のフラグメントは同じテーブル構造とセル幅を共有しなければなりません。そうでないと、ページ番号のような動的テキストが静的レイヤー上で揃いません。
  • Base64よりも小さく: 外部画像ファイルやSVGは、Base64文字列よりもファイルサイズをさらに小さくできます。
  • ヘッダーにも対応: 同じ手法がヘッダーにも適用されます。 静的な処理で画像を保持し、動的なヘッダーテキストを2回目の処理に配置します。
注意してください: v2026.6.1から、IronPDFはヘッダーとフッターを別々に処理します。 画像がヘッダーにあり、{page}がフッターのみにある場合、もしくはその逆の場合、画像は一度だけ埋め込まれるため、2回の処理は不要です。 画像と{page}が同じヘッダーまたはフッターにある場合は、上記の2回処理法を使用します。

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

もっと読む

準備はできましたか?

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