如何在C# .NET中合并PDF文件？

如何开始使用 IronPDF？

在编写任何合并代码之前，请先从 NuGet 安装 IronPDF。 该软件包支持 .NET Framework 4.6.2 及以上版本以及 .NET 5/6/7/8/9/10，因此可在控制台应用程序、ASP.NET Core 服务、Azure Functions 和 Windows Forms 项目中运行，且无需任何额外的运行时依赖项。

打开 NuGet 包管理器控制台并运行：

Install-Package IronPdf

Install-Package IronPdf

或使用 .NET CLI：

dotnet add package IronPdf

dotnet add package IronPdf

有关包括许可证密钥申请在内的分步设置指南，请参阅 IronPDF 安装概述。 安装包并应用许可证密钥后，本指南中的所有示例均可直接运行，无需修改。

如何通过编程合并 PDF 文档？

PdfDocument.Merge 方法提供了将两个 PDF 文件合并为一个 PDF 的最直接方法。 使用 PdfDocument.FromFile 加载每个源文档，将这两个对象传递给 Merge，并保存结果。

using IronPdf;

// Load two input PDF files from disk
PdfDocument pdfA = PdfDocument.FromFile("invoice_one.pdf");
PdfDocument pdfB = PdfDocument.FromFile("invoice_two.pdf");

// Merge PDF documents into a single PDF
PdfDocument merged = PdfDocument.Merge(pdfA, pdfB);

// Save the merged document
merged.SaveAs("combined_invoices.pdf");

using IronPdf;

// Load two input PDF files from disk
PdfDocument pdfA = PdfDocument.FromFile("invoice_one.pdf");
PdfDocument pdfB = PdfDocument.FromFile("invoice_two.pdf");

// Merge PDF documents into a single PDF
PdfDocument merged = PdfDocument.Merge(pdfA, pdfB);

// Save the merged document
merged.SaveAs("combined_invoices.pdf");

Imports IronPdf

' Load two input PDF files from disk
Dim pdfA As PdfDocument = PdfDocument.FromFile("invoice_one.pdf")
Dim pdfB As PdfDocument = PdfDocument.FromFile("invoice_two.pdf")

' Merge PDF documents into a single PDF
Dim merged As PdfDocument = PdfDocument.Merge(pdfA, pdfB)

' Save the merged document
merged.SaveAs("combined_invoices.pdf")

如何一次性合并多个 PDF 文件？

当您需要合并两个以上的文档时，请将 List<PdfDocument>（或任何 IEnumerable<PdfDocument>）传递给重载的 Merge 方法。 这种方法可轻松扩展，无论文件数量是三个还是数百个，都无需更改您的代码结构。

using IronPdf;

// Build a list of quarterly reports
List<PdfDocument> pdfsToMerge = new()
{
    PdfDocument.FromFile("report_q1.pdf"),
    PdfDocument.FromFile("report_q2.pdf"),
    PdfDocument.FromFile("report_q3.pdf"),
    PdfDocument.FromFile("report_q4.pdf")
};

// Combine into one annual report
PdfDocument merged = PdfDocument.Merge(pdfsToMerge);

// Save the final document
merged.SaveAs("annual_report.pdf");

using IronPdf;

// Build a list of quarterly reports
List<PdfDocument> pdfsToMerge = new()
{
    PdfDocument.FromFile("report_q1.pdf"),
    PdfDocument.FromFile("report_q2.pdf"),
    PdfDocument.FromFile("report_q3.pdf"),
    PdfDocument.FromFile("report_q4.pdf")
};

// Combine into one annual report
PdfDocument merged = PdfDocument.Merge(pdfsToMerge);

// Save the final document
merged.SaveAs("annual_report.pdf");

Imports IronPdf

' Build a list of quarterly reports
Dim pdfsToMerge As New List(Of PdfDocument) From {
    PdfDocument.FromFile("report_q1.pdf"),
    PdfDocument.FromFile("report_q2.pdf"),
    PdfDocument.FromFile("report_q3.pdf"),
    PdfDocument.FromFile("report_q4.pdf")
}

' Combine into one annual report
Dim merged As PdfDocument = PdfDocument.Merge(pdfsToMerge)

' Save the final document
merged.SaveAs("annual_report.pdf")

如何使用 MemoryStream 合并 PDF 文件？

对于无法写入磁盘或写入速度过慢的 Web 服务和无服务器函数，必须采用内存处理。 IronPDF 支持从字节数组加载 PDF 文档，并通过 @@--CODE-13975--CODE-13975 属性将合并结果公开为 MemoryStream。

using IronPdf;
using System.IO;

// Load PDF content as byte arrays (e.g., from database or HTTP response)
byte[] firstFileBytes = File.ReadAllBytes("contract_part1.pdf");
byte[] secondFileBytes = File.ReadAllBytes("contract_part2.pdf");

// Create PdfDocument objects from byte arrays
PdfDocument doc1 = new PdfDocument(firstFileBytes);
PdfDocument doc2 = new PdfDocument(secondFileBytes);

// Merge and access the result as a stream
PdfDocument merged = PdfDocument.Merge(doc1, doc2);
MemoryStream outputStream = merged.Stream;

// Optionally save to disk as well
merged.SaveAs("merged_contract.pdf");

using IronPdf;
using System.IO;

// Load PDF content as byte arrays (e.g., from database or HTTP response)
byte[] firstFileBytes = File.ReadAllBytes("contract_part1.pdf");
byte[] secondFileBytes = File.ReadAllBytes("contract_part2.pdf");

// Create PdfDocument objects from byte arrays
PdfDocument doc1 = new PdfDocument(firstFileBytes);
PdfDocument doc2 = new PdfDocument(secondFileBytes);

// Merge and access the result as a stream
PdfDocument merged = PdfDocument.Merge(doc1, doc2);
MemoryStream outputStream = merged.Stream;

// Optionally save to disk as well
merged.SaveAs("merged_contract.pdf");

Imports IronPdf
Imports System.IO

' Load PDF content as byte arrays (e.g., from database or HTTP response)
Dim firstFileBytes As Byte() = File.ReadAllBytes("contract_part1.pdf")
Dim secondFileBytes As Byte() = File.ReadAllBytes("contract_part2.pdf")

' Create PdfDocument objects from byte arrays
Dim doc1 As New PdfDocument(firstFileBytes)
Dim doc2 As New PdfDocument(secondFileBytes)

' Merge and access the result as a stream
Dim merged As PdfDocument = PdfDocument.Merge(doc1, doc2)
Dim outputStream As MemoryStream = merged.Stream

' Optionally save to disk as well
merged.SaveAs("merged_contract.pdf")

合并文件中如何保留书签和导航？

在合并 PDF 文件时，IronPDF 会保留每个源文档的书签结构。 读者可在合并输出文件的导航窗格中查看所有合并文件的完整目录，这使得用户能够轻松地在源自不同源文档的各章节之间跳转。 PDF 规范中的书签存储在文档大纲字典中，IronPDF 能为所有合并的源文件正确重建此结构。

书签的保留功能会自动生效，无需额外配置。 如果源文件包含嵌套书签（章节和子章节），合并后的输出应保留该层级结构。 对于需要统一目录而非单独的文档书签树的合并文档，目录 API 允许您在合并后构建自定义导航结构。

如果源文档在创建时未包含书签元数据，合并后的输出将不会包含该部分的目录条目。 在合规或归档环境中交付合并文件之前，请通过检查生成的 PdfDocument 上的 OutlineManager 属性来验证哪些书签已被继承。 您可以通过编程方式重命名书签标签、重新排序条目，或插入新项目，将来自不同源文档的内容整合到一个逻辑层次结构中。 对于工作流中还需进行 PDF/A 转换以实现长期归档的情况，请在合并后应用合规性转换步骤，而非对每个源文件单独处理。 一次性转换最终合并后的文档效率更高，且可避免对可能需要进一步编辑的输出结果进行重复转换。

合并后，您还可以使用页码功能为合并后的文档添加页码，当输出内容来自多个来源且长达数十页时，此功能非常有用。

如何对合并后的 PDF 文件设置密码保护？

合并后，生成的 PdfDocument 公开了 SecuritySettings，用于应用用户和所有者密码，限制打印、复制和编辑权限。

using IronPdf;

PdfDocument pdfA = PdfDocument.FromFile("part1.pdf");
PdfDocument pdfB = PdfDocument.FromFile("part2.pdf");

PdfDocument merged = PdfDocument.Merge(pdfA, pdfB);

// Require a password to open the document
merged.SecuritySettings.UserPassword = "reader123";

// Owner password controls permissions such as printing and editing
merged.SecuritySettings.OwnerPassword = "admin456";

merged.SaveAs("secured_merged.pdf");

using IronPdf;

PdfDocument pdfA = PdfDocument.FromFile("part1.pdf");
PdfDocument pdfB = PdfDocument.FromFile("part2.pdf");

PdfDocument merged = PdfDocument.Merge(pdfA, pdfB);

// Require a password to open the document
merged.SecuritySettings.UserPassword = "reader123";

// Owner password controls permissions such as printing and editing
merged.SecuritySettings.OwnerPassword = "admin456";

merged.SaveAs("secured_merged.pdf");

Imports IronPdf

Dim pdfA As PdfDocument = PdfDocument.FromFile("part1.pdf")
Dim pdfB As PdfDocument = PdfDocument.FromFile("part2.pdf")

Dim merged As PdfDocument = PdfDocument.Merge(pdfA, pdfB)

' Require a password to open the document
merged.SecuritySettings.UserPassword = "reader123"

' Owner password controls permissions such as printing and editing
merged.SecuritySettings.OwnerPassword = "admin456"

merged.SaveAs("secured_merged.pdf")

UserPassword 会在读者查看文档之前发出提示，而 OwnerPassword 则会阻止权限更改。 您可以将密码保护与打印限制、防复制标记以及数字签名结合使用。 如需了解权限选项的完整指南，PDF 安全教程涵盖了所有可用设置。

如果源文档本身受密码保护，IronPDF 可以在合并前解密加密的 PDF 文件，前提是您拥有所有者凭据。 这意味着您可以将来自不同供应商或系统的受保护文档合并为单一的、重新加密的输出文件，而无需手动解锁步骤。

如何缩小合并后 PDF 文件的大小？

合并包含大量图片的大型文档可能会生成体积庞大的输出文件，导致存储或传输困难。 IronPDF 的 PDF 压缩 API 通过以较低质量设置重新压缩嵌入的图像，在保持文本清晰度的同时，可显著减小文件大小。

using IronPdf;

PdfDocument pdfA = PdfDocument.FromFile("report_section1.pdf");
PdfDocument pdfB = PdfDocument.FromFile("report_section2.pdf");

PdfDocument merged = PdfDocument.Merge(pdfA, pdfB);

// Compress embedded images to reduce output file size
merged.CompressImages(60); // quality 0–100

merged.SaveAs("compressed_merged.pdf");

using IronPdf;

PdfDocument pdfA = PdfDocument.FromFile("report_section1.pdf");
PdfDocument pdfB = PdfDocument.FromFile("report_section2.pdf");

PdfDocument merged = PdfDocument.Merge(pdfA, pdfB);

// Compress embedded images to reduce output file size
merged.CompressImages(60); // quality 0–100

merged.SaveAs("compressed_merged.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

CompressImages 的整数参数是一个质量百分比：50 到 75 之间的值通常会将图像密集型文档的文件大小减少 40-70%，而不会对文本内容造成明显的劣化。 对于包含矢量图形和少量光栅图像的文档，虽然节省的空间较小，但仍建议将该调用包含在内。

PDF 合并的常见用例有哪些？

PdfDocument.Merge API 适用于生产环境中 .NET 应用程序的各种文档工作流程：

对于需要在合并前有选择地提取文档的工作流程，拆分 PDF API 可从源文档中提取特定的页面范围。 您可以直接在 PDF 文件之间复制页面，当需要在合并后的输出中仅显示大型文档的特定部分时，此功能非常有用。

IronPDF 还支持从合并后的文档中提取文本和图像以供后续处理，因此非常适合作为大型数据管道中核心的文档组装步骤。

下一步计划是什么？

IronPDF 的 PdfDocument.Merge 方法以最少的代码涵盖了 .NET PDF 合并场景的全部范围：双文件合并、多文件列表合并、内存处理、密码保护输出和合并后压缩。 无论输入源类型如何，每种方法都使用相同的、一致的 API。

立即开始免费试用，在您的项目中运行这些示例。 如需进行生产环境部署，请查看适合您团队规模和使用场景的许可选项。

添加合并功能后，可探索相关的文档操作：将 PDF 拆分为多个独立文件、为多页输出添加页码，或在合并后的文档所有页面上添加水印。

立即开始使用 IronPDF。

免费开始