如何在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的最直接的方法。 使用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");

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

当您需要合并两个以上的文档时，可以传递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");

如何使用MemoryStream合并PDF文件？

在磁盘写入不可能或速度过慢的情况下，内存处理是Web服务和无服务函数所需的。 IronPDF支持从字节数组加载PDF文档，并通过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");

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

当您合并PDF文件时，IronPDF会继承每个源文档的书签结构。 读者在合并输出的导航窗格中看到来自所有合并文件的完整目录，使用户可以轻松在不同源文档的章节之间跳转。 PDF规格中的书签存储在文档大纲字典中，IronPDF正确重建了所有合并来源的这种结构。

书签保留是自动完成的，无需额外配置。 如果源文件包含嵌套书签（章节和子章节），合并输出中保留了层次结构。 对于需要统一目录而不是单独的每个文档书签树的合并文档，目录API允许您在合并后构建自定义导航结构。

如果某个源文档创建时没有书签元数据，合并输出中将不会有该部分的目录条目。 在合规或存档上下文中交付合并文件之前，检查生成OutlineManager属性，以验证哪些书签已保留。 您可以程序化地重命名书签标签，重新排序条目，或注入新条目，将来自不同源文档的内容桥接成一个逻辑层次。 对于需要长时间存档的工作流，PDF/A转换可以在合并后应用，而不是针对每个源单独应用。 一次性转换最终合并的文档效率更高，并避免重新转换可能需要进一步编辑的输出。

合并后，您还可以使用页码功能向合并的文档添加页码，这在输出跨越多个源的数十页时非常有用。

如何对合并后的PDF应用密码保护？

合并后，生成的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");

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");

CompressImages的整数参数是质量百分比：50到75之间的值通常可以对图像密集的文档减少40-70%的文件大小，而不会影响文本内容的可见性。 对于包含矢量图形和最少栅格图像的文件，节省较小，但无论如何安全调用。

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

PdfDocument.Merge API适应生产.NET应用中的广泛文档工作流：

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

IronPDF还支持从合并文档中提取文本和图像以进行下游处理，使其适合作为较大数据管道中的中央文档组装步骤。

您的下一步是什么？

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

开始免费试用，在您自己的项目中运行这些示例。 对于生产部署，请查看适合您团队规模和使用的许可选项。

添加合并支持后，探索相关的文档操作：拆分PDF为单独的文件，为多页输出添加页码，或为合并文档的所有页面应用水印。

立即开始使用 IronPDF。

免费开始