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

為什麼不能直接連接 PDF 檔案位元組數組？

與文字檔案不同，PDF 文件具有複雜的內部結構，包含交叉引用表、物件定義和特定的格式要求。 簡單地將兩個 PDF 檔案作為位元組數組連接起來會破壞文件結構，導致生成的 PDF 文件無法讀取。因此，像 IronPDF 這樣的專業PDF 庫至關重要——它們理解 PDF 規範，能夠在保持文件完整性的同時正確合併 PDF 文件。 根據Stack Overflow論壇的討論，嘗試直接連接位元組數組是開發人員在嘗試合併 PDF 內容時常犯的錯誤。

如何在 C# 中使用 IronPDF 合併兩個 PDF 位元組數組：圖 2 - 功能

如何設定 IronPDF 以合併 PDF 文件？

在您的 .NET 專案中透過 NuGet 套件管理器安裝 IronPDF：

Install-Package IronPdf

如何在 C# 中使用 IronPDF 合併兩個 PDF 位元組數組：圖 3 - 安裝 從 Pixabay 上傳

或將圖片拖放到這裡。

新增必要的 using 語句以導入庫：

using IronPdf;
using System.IO;  // For MemoryStream
using System.Threading.Tasks;

using IronPdf;
using System.IO;  // For MemoryStream
using System.Threading.Tasks;

IRON VB CONVERTER ERROR developers@ironsoftware.com

對於生產伺服器環境，請套用您的許可證金鑰以存取所有功能，無需密碼限制：

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

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

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

IronPDF 支援 Windows、Linux、macOS 和 Docker 容器，使其成為 ASP.NET Core 和雲端原生應用程式的實用解決方案。

如何在 C# 中使用 IronPDF 合併兩個 PDF 位元組數組：圖 4 - 跨平台相容性

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

var PDF = PdfDocument.Merge(
    PdfDocument.FromBytes(pdfBytes1),
    PdfDocument.FromBytes(pdfBytes2));

var PDF = PdfDocument.Merge(
    PdfDocument.FromBytes(pdfBytes1),
    PdfDocument.FromBytes(pdfBytes2));

IRON VB CONVERTER ERROR developers@ironsoftware.com

以下是使用位元組數組資料合併兩個 PDF 檔案的核心程式碼範例：

public byte[] MergePdfByteArrays(byte[] firstPdf, byte[] secondPdf)
{
    // Load the first PDF file from byte array
    var pdf1 = new PdfDocument(firstPdf);
    // Load the second PDF file from byte array
    var pdf2 = new PdfDocument(secondPdf);
    // Merge PDF documents into one PDF
    var mergedPdf = PdfDocument.Merge(pdf1, pdf2);
    // Return the combined PDF as byte array
    return mergedPdf.BinaryData;
}

public byte[] MergePdfByteArrays(byte[] firstPdf, byte[] secondPdf)
{
    // Load the first PDF file from byte array
    var pdf1 = new PdfDocument(firstPdf);
    // Load the second PDF file from byte array
    var pdf2 = new PdfDocument(secondPdf);
    // Merge PDF documents into one PDF
    var mergedPdf = PdfDocument.Merge(pdf1, pdf2);
    // Return the combined PDF as byte array
    return mergedPdf.BinaryData;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此方法接受兩個 PDF 位元組數組作為輸入參數。 PdfDocument.FromBytes()方法將每個位元組陣列載入到 PdfDocument 物件中。 Merge()方法將兩個 PDF 文件合併成一個新的 PDF，保留所有內容、格式和表單欄位。

public byte[] MergePdfsWithStream(byte[] src1, byte[] src2)
{
    using (var stream = new MemoryStream())
    {
        var pdf1 = new PdfDocument(src1);
        var pdf2 = new PdfDocument(src2);
        var combined = PdfDocument.Merge(pdf1, pdf2);
        return combined.BinaryData;
    }
}

public byte[] MergePdfsWithStream(byte[] src1, byte[] src2)
{
    using (var stream = new MemoryStream())
    {
        var pdf1 = new PdfDocument(src1);
        var pdf2 = new PdfDocument(src2);
        var combined = PdfDocument.Merge(pdf1, pdf2);
        return combined.BinaryData;
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

如何實現非同步合併以獲得更好的效能？

對於處理大型 PDF 檔案或伺服器請求量大的應用程序，非同步操作可以防止執行緒阻塞。 以下程式碼展示如何非同步合併PDF文件：

public async Task<byte[]> MergePdfByteArraysAsync(byte[] firstPdf, byte[] secondPdf)
{
    return await Task.Run(() =>
    {
        var pdf1 = new PdfDocument(firstPdf);
        var pdf2 = new PdfDocument(secondPdf);
        var PDF = PdfDocument.Merge(pdf1, pdf2);
        return PDF.BinaryData;
    });
}

public async Task<byte[]> MergePdfByteArraysAsync(byte[] firstPdf, byte[] secondPdf)
{
    return await Task.Run(() =>
    {
        var pdf1 = new PdfDocument(firstPdf);
        var pdf2 = new PdfDocument(secondPdf);
        var PDF = PdfDocument.Merge(pdf1, pdf2);
        return PDF.BinaryData;
    });
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此非同步實作將 PDF 合併操作封裝在Task.Run()中，使其能夠在後台執行緒上執行。 這種方法在 ASP.NET Web 應用程式中尤其有價值，因為在處理多個 PDF 文件時，需要保持響應式請求處理。 該方法傳回一個Task<byte[]>使呼叫者能夠在不阻塞主執行緒的情況下等待結果。 上述程式碼確保在處理大型 PDF 檔案操作時實現高效的記憶體管理。

如何有效率地合併多個PDF文件？

處理多個 PDF 檔案時，請使用清單進行批次處理。 簡而言之，此解決方案可讓您將任意數量的 PDF 文件合併為一個 PDF 文件：

public byte[] MergeMultiplePdfByteArrays(List<byte[]> pdfByteArrays)
{
    if (pdfByteArrays == null || pdfByteArrays.Count == 0)
        return null;
    // Convert all byte arrays to PdfDocument objects
    var pdfDocuments = pdfByteArrays
        .Select(bytes => new PdfDocument(bytes))
        .ToList();
    // Merge all PDFs in one operation
    var PDF = PdfDocument.Merge(pdfDocuments);
    // Clean up resources
    foreach (var pdfDoc in pdfDocuments)
    {
        pdfDoc.Dispose();
    }
    return PDF.BinaryData;
}

public byte[] MergeMultiplePdfByteArrays(List<byte[]> pdfByteArrays)
{
    if (pdfByteArrays == null || pdfByteArrays.Count == 0)
        return null;
    // Convert all byte arrays to PdfDocument objects
    var pdfDocuments = pdfByteArrays
        .Select(bytes => new PdfDocument(bytes))
        .ToList();
    // Merge all PDFs in one operation
    var PDF = PdfDocument.Merge(pdfDocuments);
    // Clean up resources
    foreach (var pdfDoc in pdfDocuments)
    {
        pdfDoc.Dispose();
    }
    return PDF.BinaryData;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此方法能夠有效率地處理任意數量的 PDF 位元組數組。 它首先驗證輸入，以確保清單包含資料。 它使用 LINQ 的Select()方法，將每個位元組數組轉換為 PdfDocument 物件。 Merge()方法接受一個 PDFDocument 物件列表，並將它們全部合併到一個操作中以建立一個新文件。 資源清理很重要——在 PDF 合併後釋放單一 PdfDocument 物件有助於有效管理記憶體和資源，尤其是在處理大量或大型 PDF 檔案時。 產生的位元組數組的長度取決於所有來源 PDF 文件中的頁數。

生產應用中的最佳實踐是什麼？

請務必將 PDF 操作放在 try-catch 區塊中，以處理因 PDF 檔案損壞或受密碼保護而可能出現的異常。 使用 using 語句或明確釋放 PdfDocument 物件可以防止記憶體洩漏。 對於大規模操作，請考慮採用分頁或串流處理方法，而不是同時將整個文件載入到記憶體中。

在處理多個 PDF 文件中的選定頁面時，您也可以在合併之前提取特定的 PdfPage 頁面實例。 IronPDF全面的錯誤處理機制確保了在測試環境和生產環境中都能實現穩健的生產部署。 如果您熟悉其他 PDF 庫，您會發現 IronPDF 的 API 特別直觀，易於匯入並在您的專案中使用。

如何在 C# 中使用 IronPDF 合併兩個 PDF 位元組數組：圖 9 - 如何在 C# 中合併兩個 PDF 位元組數組 - IronPDF

結論

IronPDF 簡化了在 C# 中從位元組數組合並 PDF 文件的複雜任務，提供了一個簡潔的 API，可以自動處理 PDF 文件結構的複雜細節。 無論您是在建立文件管理系統、處理 API 回應、處理附件的文件上傳，還是處理資料庫存儲，IronPDF 的合併 PDF 功能都能無縫整合到您的 .NET 應用程式中。

該庫支援非同步操作和記憶體高效處理，使其成為桌面和伺服器應用程式的實用解決方案。 您可以編輯、轉換和儲存 PDF 文件，而無需將臨時文件寫入磁碟。 如果想提問或尋找更多答案，請造訪我們的論壇或網站。

準備好在您的應用程式中下載並實現 PDF 合併功能了嗎？ 立即開始免費試用，或瀏覽全面的API 文檔，了解 IronPDF 的全部功能，包括HTML 轉 PDF 、PDF 表單處理和數位簽章。 我們的網站提供了所有 System.IO 流程操作的完整參考文件。

如何在 C# 中使用 IronPDF 合併兩個 PDF 位元組數組：圖 10 - 許可