C#でPDFにページ番号を追加する方法

Posted at 2025-11-19

PDFドキュメントの管理において、ページ番号は不可欠な要素です。しかし、手動でひとつひとつ追加するのは非効率的で、特に大量のPDFを扱う場合、大きな負担となります。C#開発者として、プログラムでPDFにページ番号を自動追加する方法を探していませんか？

本記事では、強力なPDFライブラリであるSpire.PDF for .NETを使用して、C#でPDFドキュメントにページ番号を簡単かつ効率的に追加する方法を、ステップバイステップで解説します。このガイドを通じて、PDFドキュメント処理の自動化スキルを向上させ、日々の作業を効率化しましょう。

1. なぜPDFにページ番号が必要なのか？

PDFドキュメントにページ番号を付与することは、単なる形式的なものではありません。ドキュメントの整理、特定の情報への参照の容易さ、そして印刷時の利便性など、多くのメリットをもたらします。特に、ビジネス文書、レポート、学術論文、契約書など、ページ数の多いドキュメントでは、ページ番号がなければ情報の追跡が困難になり、誤解や混乱を招く可能性があります。

手動でのページ番号追加は、時間がかかり、人的ミスも発生しやすいため、特に大量のドキュメントを扱う際には非現実的です。C#とPDF操作ライブラリを用いることで、このプロセスを完全に自動化し、正確かつ迅速に処理することが可能になります。これにより、開発者はより重要なタスクに集中できるようになります。

2. Spire.PDF for .NETとは？

Spire.PDF for .NETは、C#やVB.NETなどの.NET言語でPDFドキュメントを操作するための、高機能かつ使いやすいライブラリです。PDFの作成、編集、変換、結合、分割、暗号化など、幅広い機能を提供します。

本記事でSpire.PDF for .NETを使用する理由は、その豊富な機能セット、直感的で分かりやすいAPI、そして安定したパフォーマンスにあります。NuGetパッケージマネージャーから簡単にインストールでき、開発者はすぐにPDF操作の自動化に着手できます。

インストール方法:

Visual StudioのNuGetパッケージマネージャーコンソールで以下のコマンドを実行します。

Install-Package Spire.Pdf

3. C#でPDFにページ番号を追加するステップバイステップガイド

ここでは、既存のPDFファイルにページ番号を追加する具体的な手順をコード例とともに解説します。

3.1. プロジェクトの準備

まず、Visual Studioで新しいC#コンソールアプリケーションを作成し、前述の方法でSpire.Pdf NuGetパッケージをインストールしてください。

3.2. 基本的なコード構造

PDFドキュメントをロードし、各ページにページ番号を追加し、最後に変更を保存するというのが基本的な流れです。

using Spire.Pdf;
using Spire.Pdf.Graphics;
using System.Drawing; // System.Drawing.dll への参照が必要です

namespace PdfPageNumbering
{
    class Program
    {
        static void Main(string[] args)
        {
            // 既存のPDFファイルをロード
            PdfDocument doc = new PdfDocument();
            doc.LoadFromFile("sample.pdf"); // 実際のファイルパスに置き換えてください

            // ページ番号を追加
            AddPageNumbers(doc);

            // 変更を新しいファイルとして保存
            doc.SaveToFile("sample_with_page_numbers.pdf");
            doc.Close();

            System.Console.WriteLine("ページ番号が追加されたPDFが保存されました。");
        }

        static void AddPageNumbers(PdfDocument doc)
        {
            // ここにページ番号追加ロジックを実装
        }
    }
}

3.3. ページ番号の追加ロジック

AddPageNumbersメソッド内に、各ページをループし、ページ番号を描画するロジックを記述します。

        static void AddPageNumbers(PdfDocument doc)
        {
            // フォントとブラシの設定
            // System.Drawing.Fontを使用する場合は、System.Drawing.dllへの参照を追加してください。
            PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("Arial", 10f, FontStyle.Regular), true);
            PdfSolidBrush brush = new PdfSolidBrush(Color.Black);

            // 全ページ数
            int totalPages = doc.Pages.Count;

            for (int i = 0; i < totalPages; i++)
            {
                PdfPageBase page = doc.Pages[i];

                // ページ番号のテキスト形式を定義 (例: "Page 1 of 10")
                string pageNumberText = string.Format("ページ {0} / {1}", i + 1, totalPages);

                // ページ番号の表示位置を計算 (例: 右下)
                // マージンを考慮して調整することも可能です。
                float x = page.Canvas.ClientSize.Width - font.MeasureString(pageNumberText).Width - 20; // 右から20pt
                float y = page.Canvas.ClientSize.Height - font.Height - 20; // 下から20pt

                // ページにページ番号を描画
                page.Canvas.DrawString(pageNumberText, font, brush, x, y);
            }
        }

コード解説:

PdfTrueTypeFontとPdfSolidBrushを使用して、ページ番号のフォントスタイル、サイズ、色を設定します。
doc.Pages.Countで総ページ数を取得します。
forループで各ページを反復処理します。
string.Formatで「ページ N / M」のような形式のページ番号文字列を作成します。
page.Canvas.ClientSize.Widthとpage.Canvas.ClientSize.Heightを使って、ページの描画領域の幅と高さを取得し、ページ番号のX、Y座標を計算します。上記例では右下に配置しています。
page.Canvas.DrawStringメソッドで、指定した位置にページ番号を描画します。

3.4. ドキュメントの保存

doc.SaveToFile("sample_with_page_numbers.pdf");で、変更が加えられたPDFドキュメントを新しいファイル名で保存します。元のファイルを上書きしないように、新しいファイル名を指定することをお勧めします。

4. ページ番号追加の応用例とヒント

Spire.PDF for .NETを使えば、上記以外にも柔軟なページ番号の追加が可能です。

特定のページ範囲にのみページ番号を追加: forループの条件を変更することで、特定のページ（例: 3ページ目から10ページ目まで）にのみページ番号を追加できます。
ヘッダーやフッターとしてページ番号を追加: ページ番号の位置を調整するだけでなく、ヘッダーやフッター領域に固定して表示することも可能です。PdfTemplateオブジェクトを使用すると、より複雑なヘッダー/フッターを作成できます。
偶数ページと奇数ページで異なる位置にページ番号を追加: i % 2 == 0のような条件分岐を使って、偶数ページと奇数ページで異なるX座標やY座標を設定できます。
エラーハンドリング: ファイルのロード時にtry-catchブロックを使用して、ファイルが見つからない、アクセス権がないなどのエラーを適切に処理することが重要です。

機能	説明
`PdfFont`	ページ番号のフォント種類、サイズ、スタイルを設定します。
`PdfBrush`	ページ番号の文字色を設定します。
`DrawString`	指定した位置に文字列を描画します。
`ClientSize`	ページの描画可能な領域のサイズを取得します。
`LoadFromFile`	既存のPDFファイルをロードします。
`SaveToFile`	変更されたPDFファイルを指定したパスに保存します。

精錬された結び

本記事では、C#とSpire.PDF for .NETライブラリを使用して、PDFドキュメントにページ番号を自動的に追加する方法を詳細に解説しました。このソリューションは、手動での作業と比較して、時間と労力を大幅に節約し、作業の正確性を向上させることができます。

Spire.PDF for .NETは、ページ番号の追加以外にも、PDFの結合、分割、変換、電子署名の追加など、多くの強力な機能を提供します。このガイドが、あなたのPDFドキュメント処理の効率化に役立つことを願っています。ぜひ、これらの機能を活用して、より高度なPDF自動化に挑戦してみてください。あなたの開発プロジェクトがよりスムーズに進むことを期待しています。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up