使用IRONPDF

如何在 C# 中合并两个 PDF 字节数组

已发布:十一月 13, 2025

在现代C#应用程序中，处理存储为字节数组的PDF文件是一项常见要求。无论是从数据库中获取PDF文档，通过web服务接收它们，还是在内存中处理它们，能够在不保存到磁盘的情况下将多个PDF文件合并为一个是至关重要的。

IronPDF通过其直观的API使这一过程变得非常简单。您可以轻松合并两个或多个PDF文件，并实现创建合并的PDF作为单个PDF输出的需求。请继续关注我们如何在C#中合并PDF字节数组以及完成此任务的不同方法。

什么是PDF字节数组，为什么要合并它们？

字节数组基本上是表示内存中PDF文件的原始二进制数据。在使用C#处理PDF文档时，您通常会遇到PDF文件以字节数组而非磁盘上的物理文件存在的情况。这在从数据库中获取PDF文件时尤为常见，在数据库中PDF文件被存储为二进制数据，或者通过服务器从REST API接收PDF文档时。

简单地连接两个PDF字节数组是行不通的——与文本文件不同，PDF文件具有复杂的内部结构，包括页眉、交叉引用表和特定格式。如果您只是尝试连接这些字节，您肯定会收到错误。您需要一个适当的PDF库来解析这些字节数组并正确地合并它们。 IronPDF处理所有这些复杂性，只需几行代码即可合并PDF文档。这是这个库帮助您理解和解决的核心问题。

如何设置IronPDF以进行PDF合并？

开始使用IronPDF很简单。首先，在您的项目中安装IronPDF NuGet包：

Install-Package IronPdf

安装完成后，将以下命名空间添加到您的C#文件：

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

了解系统和路径要求以正确处理文件是很重要的。我们可以在ASP应用程序或桌面应用程序中使用此代码。

如何在C#中合并两个PDF字节数组：图1 - IronPDF NuGet安装页面

如何使用IronPDF合并两个PDF文件字节数组？

这里有一个完整的示例，展示如何在C#中将两个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 byte array
byte[] mergedPdfBytes = combinedPdf.BinaryData;

// Save the merged PDF (optional)
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 byte array
byte[] mergedPdfBytes = combinedPdf.BinaryData;

// Save the merged PDF (optional)
File.WriteAllBytes("merged.pdf", mergedPdfBytes);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

输出

如何在C#中合并两个PDF字节数组：图2 - 合并的PDF文件

上述代码演示了核心合并功能。首先，我们从字节数组创建PdfDocument对象。 IronPDF会自动处理解析二进制数据并创建正确的PDF文档对象。

PdfDocument.Merge()方法将多个PDF文件合并为一个PDF，保留两个源文档中的所有页面、格式和内容。最后，我们可以使用BinaryData属性将合并的文档作为字节数组访问，非常适合保存到数据库或通过API发送。采用字节并将其转换为新PDF的过程由库完成，提供给我们一个新的文档。

合并PDF的其他方法是什么？

IronPDF为合并PDF文档提供了灵活的选项。当您需要合并多个PDF文件时，可以使用List重载。此方法如下所示：

// Define pdfByteArrays as a list of byte arrays
List<byte[]> pdfByteArrays = new List<byte[]>
{
    // Add sample byte arrays representing PDFs
    File.ReadAllBytes("example1.pdf"),
    File.ReadAllBytes("example2.pdf")
};

List<PdfDocument> pdfsToMerge = new List<PdfDocument>();
foreach (var byteArray in pdfByteArrays)
{
    pdfsToMerge.Add(new PdfDocument(byteArray));
}

PdfDocument combinedPdf = PdfDocument.Merge(pdfsToMerge);
byte[] finalPdfBytes = combinedPdf.BinaryData;

// Define pdfByteArrays as a list of byte arrays
List<byte[]> pdfByteArrays = new List<byte[]>
{
    // Add sample byte arrays representing PDFs
    File.ReadAllBytes("example1.pdf"),
    File.ReadAllBytes("example2.pdf")
};

List<PdfDocument> pdfsToMerge = new List<PdfDocument>();
foreach (var byteArray in pdfByteArrays)
{
    pdfsToMerge.Add(new PdfDocument(byteArray));
}

PdfDocument combinedPdf = PdfDocument.Merge(pdfsToMerge);
byte[] finalPdfBytes = combinedPdf.BinaryData;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

这种方法允许您高效地合并任意数量的PDF文档。每个PDF都是从其字节数组加载到一个PdfDocument对象中，添加到一个列表中，然后在一次操作中合并。

使用`MemoryStream`以提高灵活性

您还可以使用MemoryStream来在处理流时对过程进行更多控制。以下代码展示了这种方法：

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);
    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);
    byte[] result = merged.BinaryData;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

处理流可为较大的PDF文件提供更好的内存管理，并在与其他使用基于流的I/O系统集成时提供更大的灵活性。这个例子是有效利用流的绝佳方式。如果需要，可以检查流上的Length属性。

我如何处理常见的PDF文档合并场景？

对于一个典型的场景，您需要从数据库中获取PDF然后合并它们：

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

    foreach (int id in documentIds)
    {
        // Fetch PDF byte array from database
        byte[] pdfData = GetPdfFromDatabase(id); // Assume this function exists
        documents.Add(new PdfDocument(pdfData));
    }

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

    // The document is saved back to a stream or to the server
    byte[] resultBytes = mergedDocument.BinaryData;

    // For this example, we return a success string
    return "Merge True: Document successfully combined and saved.";
}

public PdfDocument AddPageToPdf(PdfDocument existingDoc, byte[] newPageBytes)
{
    // Create a PdfDocument object from the new page bytes
    using var stream = new MemoryStream(newPageBytes);
    var newPageDoc = new PdfDocument(stream);

    // Get the first page of the new document
    var newPage = newPageDoc.Pages[0];

    // Add the page to the existing document
    existingDoc.Pages.Add(newPage);

    // Return the modified document
    return existingDoc;
}

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

    foreach (int id in documentIds)
    {
        // Fetch PDF byte array from database
        byte[] pdfData = GetPdfFromDatabase(id); // Assume this function exists
        documents.Add(new PdfDocument(pdfData));
    }

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

    // The document is saved back to a stream or to the server
    byte[] resultBytes = mergedDocument.BinaryData;

    // For this example, we return a success string
    return "Merge True: Document successfully combined and saved.";
}

public PdfDocument AddPageToPdf(PdfDocument existingDoc, byte[] newPageBytes)
{
    // Create a PdfDocument object from the new page bytes
    using var stream = new MemoryStream(newPageBytes);
    var newPageDoc = new PdfDocument(stream);

    // Get the first page of the new document
    var newPage = newPageDoc.Pages[0];

    // Add the page to the existing document
    existingDoc.Pages.Add(newPage);

    // Return the modified document
    return existingDoc;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

这种模式非常适合需要合并发票、报告或任何其他存储在数据库中的PDF文档的场景。合并后的文档保持所有源PDF的原始质量和格式。对象完全在内存中处理。如果需要，您还可以编辑页面。

处理错误和常见错误

在实现此代码时，处理潜在的错误情况很重要。例如，如果无法读取文件（错误路径）或字节数组不代表有效的PDF，new PdfDocument()对象创建可能会抛出异常。始终使用try-catch块。如果您不熟悉系统，容易犯错误。始终在处理之前验证数组的长度。

示例：在尝试读取字节之前，始终检查文件路径是否存在。如果字节数组为null，打开操作将失败。

创建、删除或导入这些文档的权限通常由具有适当密码或站点安全权限的用户管理。这确保了对文件的安全访问，防止未经授权的写入或保存操作。此主题在IronPDF网站的额外主题中有涉及。

结论

使用IronPDF合并PDF字节数组消除了传统上与C#中PDF操作相关的复杂性。无论您是处理来自数据库的文档、API响应还是内存处理，IronPDF直观的API使合并PDF简单如同调用单个方法。我们希望这个方法帮助您实现目标。最终结果是一个干净的、合并的PDF。感谢您的阅读，如果您有进一步问题，请回复。

Get started with a free trial to experience how IronPDF can streamline your PDF processing workflows, or 探索我们的许可选项用于生产用途。

使用 NuGet 安装