如何在 C# 中合併 PDF 位元組數組

什麼是 PDF 位元組數組？為什麼要合併它們？

位元組數組是記憶體中表示 PDF 檔案的原始二進位資料。 在 C# 中處理 PDF 文件時，您經常會遇到文件以位元組數組形式存在而不是儲存在磁碟上的情況。 當從資料庫中檢索文件（其中 PDF 以二進位列的形式儲存）或從 REST API 接收文件時，這種情況尤其常見。

.NET中的MemoryStream 功能（在Microsoft MemoryStream 參考文件中有詳細說明）可以有效率地處理這些位元組數組，尤其是在與大型文件的適當記憶體管理相結合時。 與其寫入臨時文件，不如將 PDF 文件完全加載、處理和保存到記憶體中——這樣速度更快、更簡潔，並且避免了文件系統權限問題。

如何將 PDF 庫新增至專案？

首先需要將IronPDF NuGet套件加入您的專案中。 該軟體包可在NuGet上取得。 您可以使用套件管理器控制台或.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、控制台應用程式和雲端環境整合。

Visual Studio 的NuGet套件管理器介面顯示了IronPDF庫的搜尋結果，其中已選擇版本 2025.9.4 安裝到 IronTesting 專案中—"安裝"按鈕和版本下拉式選單清晰可見。

立即開始在您的項目中使用 IronPDF 並免費試用。

第一步：

免費啟動

如何在 C# 中合併兩個 PDF 位元組數組？

以下是一個完整的範例，示範如何將兩個 PDF 位元組數組合併到一個 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 類別在其建構函數中直接接受原始位元組數組。 一旦你有兩個 PdfDocument 實例，PdfDocument.Merge() 就會將它們合併到一個文件中。 然後，BinaryData 屬性會將結果以位元組數組的形式傳回，以便儲存回資料庫或透過 API 傳輸。

PdfDocument API除了簡單的合併功能外，還提供了廣泛的功能，包括頁面操作、文字擷取和表單處理。 合併文件後，您可以在提取最終位元組數組之前套用這些操作中的任何一個。

如何一次合併兩個以上的PDF檔案？

IronPDF提供了一個 List 重載，用於在一次操作中合併任意數量的文件。 這比多次合併兩份文檔效率更高：

// 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 物件中，加入到清單中，然後在一次呼叫中合併。 對於大型輸出文件， 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}";
    }
}

這種模式能夠優雅地處理缺失或空的記錄，跳過它們並繼續處理有效文件。 合併後的結果會在寫回資料庫之前，透過 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還涵蓋了完整的 PDF 處理生命週期： HTML 到 PDF 轉換、 PDF 編輯、表單建立和填寫、文字擷取、數位簽章和安全管理。 一旦合併工作流程正常運行，這些功能就可以無縫集成，無需任何其他依賴項。

造訪IronPDF教學頁面，了解每個主要功能的完整演練，或查看API 參考文檔，以取得每個類別和方法的詳細文檔。

立即開始在您的項目中使用 IronPDF 並免費試用。

第一步：

免費啟動