C#でプログラム的にPDFページを並べ替える方法

IronPDFを始めるにはどうすればいいですか？

NuGetパッケージ マネージャーまたは.NET CLI を使用して、数秒で任意 for .NET 8 または.NET 10 プロジェクトにIronPDF を追加します。 Windows、Linux、macOS では追加のランタイム依存関係やネイティブ バイナリは必要ありません。

dotnet add package IronPdf

dotnet add package IronPdf

パッケージをインストールしたら、C#ファイルの先頭にusing IronPdf;を追加してください。有効なライセンスキーを取得すると、商用利用が完全に可能になります。 評価用に無料の試用ライセンスが利用可能です。 API を呼び出す前にキーを設定します。

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

パッケージが参照され、ライセンスが設定されている場合、この記事のすべての例は変更なしで実行されます。 IronPDF NuGetパッケージは.NET Standard 2.0 以上を対象としているため、 .NET Framework 4.6.2 以降、 .NET Core、およびすべての最新 for .NETバージョンで動作します。

C# でページの並べ替えはどのように機能しますか?

C# を使用して PDF のページを並べ替えるプロセスは、ソースドキュメントの読み込み、ページインデックス配列を使用して目的のページ順序の指定、そして出力ファイルの保存で構成されます。IronPDFには、PDF からページを抽出して新しいオブジェクトに並べ替える CopyPages メソッドが用意されています。

次のコードは、ターゲット シーケンスを定義する新しい int 配列を作成してページの順序を変更する方法を示しています。 配列の各値は、原文のページインデックスを表し、ページはゼロベースのインデックスを使用します(ページ0は最初のページです)。

using IronPdf;

// Load the source document from file path
var pdf = PdfDocument.FromFile("quarterly-report.pdf");

// Define new page order: move page 3 to front, then pages 1, 2, 0
int[] pageOrder = new int[] { 3, 1, 2, 0 };

// Copy each requested page into its own PdfDocument
var pageDocs = new List<PdfDocument>();
foreach (var idx in pageOrder)
{
    // CopyPage returns a PdfDocument containing only that page
    var single = pdf.CopyPage(idx);
    pageDocs.Add(single);
}

// Merge the single-page docs into one ordered document
using var merged = PdfDocument.Merge(pageDocs.ToArray());

// Save the new ordered PDF
merged.SaveAs("report-reorganized.pdf");

using IronPdf;

// Load the source document from file path
var pdf = PdfDocument.FromFile("quarterly-report.pdf");

// Define new page order: move page 3 to front, then pages 1, 2, 0
int[] pageOrder = new int[] { 3, 1, 2, 0 };

// Copy each requested page into its own PdfDocument
var pageDocs = new List<PdfDocument>();
foreach (var idx in pageOrder)
{
    // CopyPage returns a PdfDocument containing only that page
    var single = pdf.CopyPage(idx);
    pageDocs.Add(single);
}

// Merge the single-page docs into one ordered document
using var merged = PdfDocument.Merge(pageDocs.ToArray());

// Save the new ordered PDF
merged.SaveAs("report-reorganized.pdf");

複数のページを一度に並べ替えるにはどうすればよいですか?

PDF ドキュメントに多数のページが含まれている場合、1 回のパスで全体の構造を並べ替えることができます。 以下のコードは、インデックス配列をプログラムで計算して、すべてのページを反転したり、カスタム シーケンスを作成したりする方法を示しています。

using IronPdf;

// Load PDF document with several pages
var doc = PdfDocument.FromFile("quarterly-report.pdf");
int count = doc.PageCount;

// Build reversed single-page PDFs
var pages = new List<PdfDocument>();
for (int i = count - 1; i >= 0; i--)
{
    // Copy a single page as a standalone PdfDocument
    pages.Add(doc.CopyPage(i));
}

// Merge all the reversed single-page PDFs
using var reversed = PdfDocument.Merge(pages.ToArray());

// Save to a new filename
reversed.SaveAs("report-reversed.pdf");

using IronPdf;

// Load PDF document with several pages
var doc = PdfDocument.FromFile("quarterly-report.pdf");
int count = doc.PageCount;

// Build reversed single-page PDFs
var pages = new List<PdfDocument>();
for (int i = count - 1; i >= 0; i--)
{
    // Copy a single page as a standalone PdfDocument
    pages.Add(doc.CopyPage(i));
}

// Merge all the reversed single-page PDFs
using var reversed = PdfDocument.Merge(pages.ToArray());

// Save to a new filename
reversed.SaveAs("report-reversed.pdf");

単一のページを新しい場所に移動するにはどうすればよいですか?

1 ページを別の位置に移動するには、コピー、削除、挿入を組み合わせる必要があります。 InsertPdf メソッドは、ターゲット ドキュメント内の任意のインデックスに PdfDocument を配置します。

using IronPdf;

// Load the input PDF file
var pdf = PdfDocument.FromFile("presentation.pdf");
int sourceIndex = 1;   // page to move
int targetIndex = 3;   // destination position

// Track direction to handle index shift after removal
bool movingForward = targetIndex > sourceIndex;

// 1. Copy the page to move (produces a one-page PdfDocument)
var pageDoc = pdf.CopyPage(sourceIndex);

// 2. Remove the original page from its current position
pdf.RemovePage(sourceIndex);

// 3. Adjust target index if moving forward (removal shifts remaining pages left)
if (movingForward)
    targetIndex--;

// 4. Insert the copied page at the target position
pdf.InsertPdf(pageDoc, targetIndex);

// Save the result
pdf.SaveAs("presentation-reordered.pdf");

using IronPdf;

// Load the input PDF file
var pdf = PdfDocument.FromFile("presentation.pdf");
int sourceIndex = 1;   // page to move
int targetIndex = 3;   // destination position

// Track direction to handle index shift after removal
bool movingForward = targetIndex > sourceIndex;

// 1. Copy the page to move (produces a one-page PdfDocument)
var pageDoc = pdf.CopyPage(sourceIndex);

// 2. Remove the original page from its current position
pdf.RemovePage(sourceIndex);

// 3. Adjust target index if moving forward (removal shifts remaining pages left)
if (movingForward)
    targetIndex--;

// 4. Insert the copied page at the target position
pdf.InsertPdf(pageDoc, targetIndex);

// Save the result
pdf.SaveAs("presentation-reordered.pdf");

MemoryStream を使用してページを削除し、順序を変更するにはどうすればよいでしょうか?

PDF ワークフローを自動化するアプリケーションでは、中間ファイルをディスクに書き込まずにドキュメントを操作する必要がある場合があります。 バイト配列からロードして MemoryStream にエクスポートすると、すべての処理がメモリ内に保持されるため、一時的な操作が高速化され、コンテナ化された環境やサーバーレス環境でのファイルシステムのアクセス許可の問題を回避できます。

using IronPdf;
using System.IO;

// Load PDF from byte array (simulating input from a database or API response)
byte[] pdfBytes = File.ReadAllBytes("report-with-blank.pdf");
var pdf = new PdfDocument(pdfBytes);

// Delete the blank page at index 2 (zero-based)
pdf.RemovePage(2);

// Reorder remaining pages: new sequence from a four-page document
var reorderedPdf = pdf.CopyPages(new int[] { 1, 0, 2, 3 });

// Export to MemoryStream for further processing (e.g., HTTP response body)
MemoryStream outputStream = reorderedPdf.Stream;

// Or save directly using the BinaryData property
File.WriteAllBytes("cleaned-report.pdf", reorderedPdf.BinaryData);

using IronPdf;
using System.IO;

// Load PDF from byte array (simulating input from a database or API response)
byte[] pdfBytes = File.ReadAllBytes("report-with-blank.pdf");
var pdf = new PdfDocument(pdfBytes);

// Delete the blank page at index 2 (zero-based)
pdf.RemovePage(2);

// Reorder remaining pages: new sequence from a four-page document
var reorderedPdf = pdf.CopyPages(new int[] { 1, 0, 2, 3 });

// Export to MemoryStream for further processing (e.g., HTTP response body)
MemoryStream outputStream = reorderedPdf.Stream;

// Or save directly using the BinaryData property
File.WriteAllBytes("cleaned-report.pdf", reorderedPdf.BinaryData);

PdfDocument コンストラクターは byte[] を直接受け入れ、Stream プロパティは結果の PDF を MemoryStream として返します。 このパターンは、ファイル応答を返すASP.NET Coreコントローラー、Blob Storage の読み取りと書き込みを行う Azure Functions、およびメッセージ キューから PDF のバッチを処理するバックグラウンド サービスに適しています。 ライブラリは、埋め込まれた画像を含む大きなドキュメントでもメモリ管理を効率的に処理します。

回転、抽出、スタンプなどのページ操作方法の完全なセットを確認するには、 PdfDocument API リファレンスを参照してください。

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/pdf")]
public class PdfController : ControllerBase
{
    [HttpPost("reorder")]
    public IActionResult Reorder(IFormFile file, [FromQuery] string order)
    {
        // Parse comma-separated page indexes from query string
        var indexes = order.Split(',').Select(int.Parse).ToArray();

        using var stream = file.OpenReadStream();
        using var ms = new System.IO.MemoryStream();
        stream.CopyTo(ms);

        var pdf = new PdfDocument(ms.ToArray());
        var reordered = pdf.CopyPages(indexes);

        // Return the reordered PDF as a downloadable file
        return File(reordered.BinaryData, "application/pdf", "reordered.pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/pdf")]
public class PdfController : ControllerBase
{
    [HttpPost("reorder")]
    public IActionResult Reorder(IFormFile file, [FromQuery] string order)
    {
        // Parse comma-separated page indexes from query string
        var indexes = order.Split(',').Select(int.Parse).ToArray();

        using var stream = file.OpenReadStream();
        using var ms = new System.IO.MemoryStream();
        stream.CopyTo(ms);

        var pdf = new PdfDocument(ms.ToArray());
        var reordered = pdf.CopyPages(indexes);

        // Return the reordered PDF as a downloadable file
        return File(reordered.BinaryData, "application/pdf", "reordered.pdf");
    }
}

並べ替え後に PDF を結合するにはどうすればよいですか?

ページの順序を変更する場合は、複数のソース ファイルのコンテンツを結合することがよくあります。 IronPDF の PdfDocument.Merge メソッドは、 PdfDocument オブジェクトの配列を受け入れ、指定された順序でそれらを結合します。これは、上記のページコピー手法と自然に組み合わせられます。

using IronPdf;

// Load two separate PDF files
var docA = PdfDocument.FromFile("section-a.pdf");
var docB = PdfDocument.FromFile("section-b.pdf");

// Reorder pages within each source document
var reorderedA = docA.CopyPages(new int[] { 1, 0, 2 });
var reorderedB = docB.CopyPages(new int[] { 0, 2, 1 });

// Merge into a single output document
using var combined = PdfDocument.Merge(reorderedA, reorderedB);
combined.SaveAs("combined-report.pdf");

using IronPdf;

// Load two separate PDF files
var docA = PdfDocument.FromFile("section-a.pdf");
var docB = PdfDocument.FromFile("section-b.pdf");

// Reorder pages within each source document
var reorderedA = docA.CopyPages(new int[] { 1, 0, 2 });
var reorderedB = docB.CopyPages(new int[] { 0, 2, 1 });

// Merge into a single output document
using var combined = PdfDocument.Merge(reorderedA, reorderedB);
combined.SaveAs("combined-report.pdf");

結合後の結果のドキュメントには、reorderedA のすべてのページと、それに続いて reorderedB のすべてのページが含まれます。 追加の Merge 呼び出しを連鎖したり、さらにドキュメントを渡して任意の数のソースを組み合わせることができます。 IronPDF のマージと分割のドキュメントでは、逆の操作であるドキュメントを個別のセクションに分割する方法について説明します。

バイト配列とメモリ内ドキュメントのマージについてさらに詳しく知るには、 C# でバイト配列から PDF をマージする方法についてのガイドを参照してください。このガイドでは、ドキュメントがファイル パスではなくバイナリ BLOB として保存される、データベース ベースのワークフローについて説明します。

PDF ページ管理のベストプラクティスは何ですか?

防御的なコーディング習慣により、大規模な PDF ページの操作時に、微妙なバグや製品障害が発生するのを防ぐことができます。 これらの方法を一貫して適用すると、ページ順序を変更するコードのテストと保守が容易になります。

ページ インデックスを CopyPages または RemovePage に渡す前に、必ず PdfDocument.PageCount に対して検証してください。 インデックスがArgumentOutOfRangeExceptionが発生します。1行のガードチェックにより、このカテゴリのエラーは完全に排除されます。

複数ページの並べ替えを行う場合は、手動で CopyPage をループするよりも、CopyPages(IEnumerable<int>) のオーバーロードを使用することをお勧めします。 バッチオーバーロードは、シーケンス全体を1回のパスで処理するため、割り当てと実行時間の両方を削減します。ページごとのループパターンは、マージ前に個々のページを回転させるなど、ページごとに変換を適用する必要がある場合に使用します。

中間の PdfDocument オブジェクトを using ステートメントでラップして、管理されていないリソースが使用後すぐに解放されるようにします。 これは、中間オブジェクトがすぐに破棄されない場合、多くのドキュメントがメモリに蓄積される可能性がある Web リクエスト ハンドラーとバックグラウンド ジョブでは特に重要です。 IronPDFトラブルシューティング ガイドでは、一般的なメモリとパフォーマンスのパターンについて詳しく説明します。

ドキュメント自動化パイプラインを構築するときは、並べ替えロジックをファイルの入出力から分離することを検討してください。 ユニット テストを高速に保ち、ファイル システムの依存関係を回避するには、サービス レイヤーで byte[] または MemoryStream を受け入れて返します。 PDF ページ操作のIronPDF の例では、ファイル パス ワークフローとメモリ内ワークフローの両方のパターンが並べて示されています。

次のステップは何ですか?

IronPDFを使用して C# で PDF ページを並べ替えると、複雑なドキュメント操作タスクがいくつかのメソッド呼び出しに削減されます。 この記事で取り上げる主な手法には、CopyPages を使用してインデックス配列でページを並べ替える、ループを使用してプログラムですべてのページを逆にする、RemovePage、および InsertPdf を組み合わせて 1 ページを移動する、並べ替える前に不要なページを削除する、バイト配列と MemoryStream を使用してドキュメントを完全にメモリ内で処理する、などがあります。

これらの各パターンは、 IronPDF の機能セットの残りの部分と統合されます。 ページを並べ替えた後、透かしやスタンプを追加したり、個々のページをトリミングしたり、ページ番号を追加したりして、最終文書を配信することができます。 IronPDF のハウツー ガイドには、これらの後続操作のそれぞれに対するコード例が提供されています。

無料の試用ライセンスから始めて、ページの並べ替えやその他すべてのIronPDF機能を独自の環境でテストしてください。 展開の準備ができたら、 IronPDF のライセンス オプションを確認し、プロジェクトの要件に適した層を見つけます。 デジタル署名、PDF/A 準拠、アクセシビリティ タグ付けなどの高度なシナリオを調べる必要があるときはいつでも、 IronPDF のドキュメントとオブジェクト リファレンスを利用できます。