您如何在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");

如何一次合併多個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");

如何使用 MemoryStream 合併 PDF 檔案？

對於無法寫入磁碟或寫入磁碟速度太慢的 Web 服務和無伺服器函數，需要進行記憶體處理。 IronPDF支援從位元組數組載入 PDF 文檔，並透過 Stream 屬性將合併結果公開為 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允許您在合併後建立自訂導覽結構。

如果來源文件在建立時沒有書籤元數據，則合併後的輸出將不包含該部分的大綱條目。 在合規或歸檔環境中交付合併文件之前，請檢查生成的 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");

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

CompressImages 的整數參數是一個質量百分比：50 到 75 之間的值通常會將圖像密集型文件的文件大小減少 40-70%，而不會對文字內容造成明顯的劣化。 對於包含向量圖形和少量柵格圖像的文檔，節省的空間較小，但無論如何，調用該函數都是安全的。

PDF合併的常見應用場景有哪些？

PdfDocument.Merge API 適用於生產環境中.NET應用程式的各種文件工作流程：

對於需要在合併之前選擇性地提取文件的工作流程，拆分 PDF API可以從來源文件中提取特定的頁面範圍。 您可以直接在 PDF 文件之間複製頁面，這在只需要在合併輸出中顯示大型文件的某些部分時非常有用。

IronPDF也支援從合併的文件中擷取文字和影像以進行下游處理，使其適合作為大型資料管道中的中心文件組裝步驟。

下一步計劃是什麼？

IronPDF 的 PdfDocument.Merge 方法以最少的程式碼涵蓋了.NET PDF 合併場景的全部範圍：雙檔案合併、多檔案清單合併、記憶體處理、密碼保護輸出和合併後壓縮。 無論輸入來源類型為何，所有方法都使用相同的統一 API。

立即開始免費試用，在您自己的專案中執行這些範例。 對於生產環境部署，請查看適合您團隊規模和使用情況的授權選項。

新增合併支援後，探索相關的文件操作：將 PDF 拆分為單獨的文件、向多頁輸出添加頁碼或向合併文檔中的所有頁面套用浮水印。

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

第一步：

免費啟動