C#でPDFバイト配列をマージする方法

PDFバイト配列とは何か、なぜマージする必要があるのか？

バイト配列は、メモリ内の PDF ファイルを表す生のバイナリ データです。 C# で PDF ドキュメントを操作する場合、ファイルがディスク上ではなくバイト配列として存在するシナリオに遭遇することがよくあります。 これは、PDF がバイナリ列として保存されているデータベースからドキュメントを取得する場合や、REST API からドキュメントを受信する場合に特によく発生します。

.NETのMemoryStream 機能( Microsoft MemoryStream リファレンスに記載) を使用すると、特に大規模なドキュメントの適切なメモリ管理と組み合わせると、これらのバイト配列の処理が効率的になります。 一時ファイルを書き込むのではなく、PDF を完全にメモリ内で読み込み、処理し、保存することができます。これにより、処理速度が速くなり、クリーンになり、ファイル システムのアクセス許可の問題を回避できます。

PDF ライブラリをプロジェクトに追加するにはどうすればよいですか?

開始するには、 IronPDF NuGetパッケージをプロジェクトに追加する必要があります。 パッケージはNuGet.orgから入手できます。 パッケージ マネージャー コンソールまたは.NET CLI を使用してインストールできます。

Install-Package IronPdf

Install-Package IronPdf

dotnet add package IronPdf

dotnet add package IronPdf

Docker デプロイメントやLinux セットアップなどの詳細なインストール オプションについては、高度なインストール ガイドを参照してください。 最小限の環境に展開する場合、 IronPDF Slim により展開フットプリントが大幅に削減されます。

インストールしたら、C# ファイルの先頭に次の名前空間を追加します。

using IronPdf;
using System.IO;
using System.Collections.Generic;

using IronPdf;
using System.IO;
using System.Collections.Generic;

IronPDF は、Windows、macOS、Linuxプラットフォームをサポートしています。 追加の構成なしで、 ASP.NET Core 、 Blazor、コンソール アプリケーション、クラウド環境と統合されます。

今IronPDFを始めましょう。

無料で始める

C# で 2 つの PDF バイト配列を結合するにはどうすればよいですか?

以下は、2 つの PDF バイト配列を 1 つの PDF ドキュメントに結合する方法を示す完全な例です。

// Simulate two PDF byte arrays (in practice, these come from a database or API)
byte[] pdfBytes1 = File.ReadAllBytes("document1.pdf");
byte[] pdfBytes2 = File.ReadAllBytes("document2.pdf");

// Create PdfDocument objects from byte arrays
var pdf1 = new PdfDocument(pdfBytes1);
var pdf2 = new PdfDocument(pdfBytes2);

// Merge the two PDF documents
PdfDocument combinedPdf = PdfDocument.Merge(pdf1, pdf2);

// Convert the combined PDF back to a byte array
byte[] mergedPdfBytes = combinedPdf.BinaryData;

// Optionally save the merged PDF to disk
File.WriteAllBytes("merged.pdf", mergedPdfBytes);

// Simulate two PDF byte arrays (in practice, these come from a database or API)
byte[] pdfBytes1 = File.ReadAllBytes("document1.pdf");
byte[] pdfBytes2 = File.ReadAllBytes("document2.pdf");

// Create PdfDocument objects from byte arrays
var pdf1 = new PdfDocument(pdfBytes1);
var pdf2 = new PdfDocument(pdfBytes2);

// Merge the two PDF documents
PdfDocument combinedPdf = PdfDocument.Merge(pdf1, pdf2);

// Convert the combined PDF back to a byte array
byte[] mergedPdfBytes = combinedPdf.BinaryData;

// Optionally save the merged PDF to disk
File.WriteAllBytes("merged.pdf", mergedPdfBytes);

PdfDocument クラスは、コンストラクター内で生のバイト配列を直接受け入れます。 2 つの PdfDocument インスタンスが作成されると、PdfDocument.Merge() によってそれらが 1 つのドキュメントに結合されます。 BinaryData プロパティは、結果をバイト配列として提供し、データベースに保存したり、API 経由で送信したりできるようになります。

PdfDocument API は、単純なマージだけでなく、ページ操作、テキスト抽出、フォーム処理など、幅広い機能を提供します。 結合されたドキュメントができたら、最終的なバイト配列を抽出する前に、これらの操作のいずれかを適用できます。

2 つ以上の PDF ファイルを一度に結合するにはどうすればよいでしょうか?

IronPDF は、1 回の操作で任意の数のドキュメントを結合するための List オーバーロードを提供します。 これは、2 つのドキュメントのマージを複数連鎖するよりも効率的です。

// Load four PDFs as byte arrays
List<byte[]> pdfByteArrays = new List<byte[]>
{
    File.ReadAllBytes("example1.pdf"),
    File.ReadAllBytes("example2.pdf"),
    File.ReadAllBytes("example3.pdf"),
    File.ReadAllBytes("example4.pdf")
};

// Convert each byte array to a PdfDocument
List<PdfDocument> pdfsToMerge = new List<PdfDocument>();
for (int i = 0; i < pdfByteArrays.Count; i++)
{
    pdfsToMerge.Add(new PdfDocument(pdfByteArrays[i]));
}

// Merge all documents in one call
PdfDocument combinedPdf = PdfDocument.Merge(pdfsToMerge);
byte[] finalPdfBytes = combinedPdf.BinaryData;

// Apply compression if the result is large
if (finalPdfBytes.Length > 1024 * 1024 * 10) // 10 MB
{
    combinedPdf.CompressImages(90);
    finalPdfBytes = combinedPdf.BinaryData;
}

// Load four PDFs as byte arrays
List<byte[]> pdfByteArrays = new List<byte[]>
{
    File.ReadAllBytes("example1.pdf"),
    File.ReadAllBytes("example2.pdf"),
    File.ReadAllBytes("example3.pdf"),
    File.ReadAllBytes("example4.pdf")
};

// Convert each byte array to a PdfDocument
List<PdfDocument> pdfsToMerge = new List<PdfDocument>();
for (int i = 0; i < pdfByteArrays.Count; i++)
{
    pdfsToMerge.Add(new PdfDocument(pdfByteArrays[i]));
}

// Merge all documents in one call
PdfDocument combinedPdf = PdfDocument.Merge(pdfsToMerge);
byte[] finalPdfBytes = combinedPdf.BinaryData;

// Apply compression if the result is large
if (finalPdfBytes.Length > 1024 * 1024 * 10) // 10 MB
{
    combinedPdf.CompressImages(90);
    finalPdfBytes = combinedPdf.BinaryData;
}

このアプローチは、任意の数のドキュメントに拡張できます。 各 PDF は PdfDocument オブジェクトに読み込まれ、リストに追加されてから、1 回の呼び出しで結合されます。 大きな出力ファイルの場合、 PDF 圧縮により、品質を損なうことなく最終的なサイズが縮小されます。

using (var stream1 = new MemoryStream(pdfBytes1))
using (var stream2 = new MemoryStream(pdfBytes2))
{
    var pdf1 = new PdfDocument(stream1);
    var pdf2 = new PdfDocument(stream2);

    var merged = PdfDocument.Merge(pdf1, pdf2);

    // Add metadata to the merged document
    merged.MetaData.Author = "Your Application";
    merged.MetaData.Title = "Merged Document";
    merged.MetaData.CreationDate = DateTime.Now;

    byte[] result = merged.BinaryData;
}

using (var stream1 = new MemoryStream(pdfBytes1))
using (var stream2 = new MemoryStream(pdfBytes2))
{
    var pdf1 = new PdfDocument(stream1);
    var pdf2 = new PdfDocument(stream2);

    var merged = PdfDocument.Merge(pdf1, pdf2);

    // Add metadata to the merged document
    merged.MetaData.Author = "Your Application";
    merged.MetaData.Title = "Merged Document";
    merged.MetaData.CreationDate = DateTime.Now;

    byte[] result = merged.BinaryData;
}

データベースから取得した PDF を結合するにはどうすればよいでしょうか?

実際の一般的なパターンでは、SQL データベースから PDF バイト配列を取得し、必要に応じてそれらを結合します。 以下はエラー処理を備えた本番環境対応の例です。

public string MergePdfDocumentsFromDatabase(List<int> documentIds)
{
    List<PdfDocument> documents = new List<PdfDocument>();

    try
    {
        foreach (int id in documentIds)
        {
            // Fetch PDF byte array from database
            byte[] pdfData = GetPdfFromDatabase(id); // Replace with your data access logic

            if (pdfData == null || pdfData.Length == 0)
            {
                Console.WriteLine($"Warning: Document {id} is empty or not found");
                continue;
            }

            documents.Add(new PdfDocument(pdfData));
        }

        if (documents.Count == 0)
        {
            return "Error: No valid documents found to merge";
        }

        // Merge all documents
        PdfDocument mergedDocument = PdfDocument.Merge(documents);

        // Add page numbers to the footer
        mergedDocument.AddHtmlFooters(new HtmlHeaderFooter()
        {
            HtmlFragment = "<center>Page {page} of {total-pages}</center>",
            DrawDividerLine = true
        });

        // Save back to the database
        byte[] resultBytes = mergedDocument.BinaryData;
        SaveMergedPdfToDatabase(resultBytes);

        return "Document successfully combined and saved.";
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error merging PDFs: {ex.Message}");
        return $"Merge failed: {ex.Message}";
    }
}

public string MergePdfDocumentsFromDatabase(List<int> documentIds)
{
    List<PdfDocument> documents = new List<PdfDocument>();

    try
    {
        foreach (int id in documentIds)
        {
            // Fetch PDF byte array from database
            byte[] pdfData = GetPdfFromDatabase(id); // Replace with your data access logic

            if (pdfData == null || pdfData.Length == 0)
            {
                Console.WriteLine($"Warning: Document {id} is empty or not found");
                continue;
            }

            documents.Add(new PdfDocument(pdfData));
        }

        if (documents.Count == 0)
        {
            return "Error: No valid documents found to merge";
        }

        // Merge all documents
        PdfDocument mergedDocument = PdfDocument.Merge(documents);

        // Add page numbers to the footer
        mergedDocument.AddHtmlFooters(new HtmlHeaderFooter()
        {
            HtmlFragment = "<center>Page {page} of {total-pages}</center>",
            DrawDividerLine = true
        });

        // Save back to the database
        byte[] resultBytes = mergedDocument.BinaryData;
        SaveMergedPdfToDatabase(resultBytes);

        return "Document successfully combined and saved.";
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error merging PDFs: {ex.Message}");
        return $"Merge failed: {ex.Message}";
    }
}

このパターンは、欠落したレコードや null レコードをスキップし、有効なドキュメントを続行することで、それらのレコードを適切に処理します。 マージされた結果には、データベースに書き戻される前に、 HTML ヘッダー/フッターを介してページ番号が追加されます。 より高度なナビゲーションのために、長い結合されたドキュメント内を読者がナビゲートできるようにブックマークを追加できます。

エラーやエッジケースをどのように処理しますか?

public bool TryMergePdfByteArrays(byte[] pdfBytes1, byte[] pdfBytes2, out byte[] mergedBytes)
{
    mergedBytes = null;

    try
    {
        if (pdfBytes1 == null || pdfBytes1.Length == 0)
            throw new ArgumentException("First PDF byte array is null or empty");

        if (pdfBytes2 == null || pdfBytes2.Length == 0)
            throw new ArgumentException("Second PDF byte array is null or empty");

        using var pdf1 = new PdfDocument(pdfBytes1);
        using var pdf2 = new PdfDocument(pdfBytes2);

        if (pdf1.PageCount == 0)
            throw new InvalidOperationException("First PDF has no pages");

        if (pdf2.PageCount == 0)
            throw new InvalidOperationException("Second PDF has no pages");

        var mergedPdf = PdfDocument.Merge(pdf1, pdf2);
        mergedBytes = mergedPdf.BinaryData;

        return true;
    }
    catch (Exception ex)
    {
        Console.WriteLine($"PDF merge failed: {ex.Message}");
        return false;
    }
}

public bool TryMergePdfByteArrays(byte[] pdfBytes1, byte[] pdfBytes2, out byte[] mergedBytes)
{
    mergedBytes = null;

    try
    {
        if (pdfBytes1 == null || pdfBytes1.Length == 0)
            throw new ArgumentException("First PDF byte array is null or empty");

        if (pdfBytes2 == null || pdfBytes2.Length == 0)
            throw new ArgumentException("Second PDF byte array is null or empty");

        using var pdf1 = new PdfDocument(pdfBytes1);
        using var pdf2 = new PdfDocument(pdfBytes2);

        if (pdf1.PageCount == 0)
            throw new InvalidOperationException("First PDF has no pages");

        if (pdf2.PageCount == 0)
            throw new InvalidOperationException("Second PDF has no pages");

        var mergedPdf = PdfDocument.Merge(pdf1, pdf2);
        mergedBytes = mergedPdf.BinaryData;

        return true;
    }
    catch (Exception ex)
    {
        Console.WriteLine($"PDF merge failed: {ex.Message}");
        return false;
    }
}

制作現場で PDF 結合を始めるにはどうすればよいでしょうか?

IronPDF はフル機能の無料トライアルを提供しているので、ライセンスを購入する前に実際のアプリケーションで PDF の結合をテストできます。 トライアルには、マージ、分割、変換、注釈、署名などの完全な API が含まれており、評価中に機能制限はありません。

実稼働環境での使用の場合、ライセンス オプションは、単一の開発者ライセンスから、無制限の展開をカバーするエンタープライズ サイト ライセンスまで多岐にわたります。 大量のワークフローを実行している組織は、再配布可能なシナリオ向けにOEM ライセンスを検討できます。

IronPDF は、マージ以外にも、 HTML から PDF への変換、 PDF 編集、フォームの作成と入力、テキスト抽出、デジタル署名、セキュリティ管理など、PDF 処理のライフサイクル全体をカバーします。 マージ ワークフローが機能するようになると、追加の依存関係なしでこれらの機能が組み込まれます。

IronPDFチュートリアル ページにアクセスして、各主要機能の完全なチュートリアルを確認するか、 API リファレンスで各クラスとメソッドの詳細なドキュメントを確認してください。

購入の準備ができていませんか？

PM >  Install-Package IronPdf

IronPDF を NuGet でチェックしてください。1000万回以上のダウンロードで、C#によるPDF開発を変革しています。 DLL または Windowsインストーラー をダウンロードすることもできます。