.NET Merge PDF: Łączenie wielu plików za pomocą IronPDF

Jak zainstalować bibliotekę?

Aby rozpocząć, wystarczy zainstalować prosty pakiet NuGet. Otwórz konsolę menedżera pakietów w Visual Studio i uruchom:

Install-Package IronPdf

Install-Package IronPdf

Lub użyj interfejsu CLI platformy .NET:

dotnet add package IronPdf

dotnet add package IronPdf

IronPDF zajmuje się wszystkimi skomplikowanymi operacjami na plikach PDF w tle, pozwalając Ci skupić się na logice aplikacji. Proces ten jest kompatybilny z różnymi systemami operacyjnymi, w tym z systemem Linux poprzez .NET Core. Szczegółowe instrukcje dotyczące instalacji można znaleźć w dokumentacji instalacyjnej IronPDF.

Jak połączyć dwa dokumenty PDF?

Najbardziej podstawowy scenariusz scalania polega na połączeniu dwóch istniejących obiektów PdfDocument. Oto jak wykonać to zadanie:

using IronPdf;

// Load the PDF documents
var pdf1 = PdfDocument.FromFile("Invoice1.pdf");
var pdf2 = PdfDocument.FromFile("Invoice2.pdf");

// Merge the documents
var merged = PdfDocument.Merge(pdf1, pdf2);

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

using IronPdf;

// Load the PDF documents
var pdf1 = PdfDocument.FromFile("Invoice1.pdf");
var pdf2 = PdfDocument.FromFile("Invoice2.pdf");

// Merge the documents
var merged = PdfDocument.Merge(pdf1, pdf2);

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

Imports IronPdf

' Load the PDF documents
Dim pdf1 = PdfDocument.FromFile("Invoice1.pdf")
Dim pdf2 = PdfDocument.FromFile("Invoice2.pdf")

' Merge the documents
Dim merged = PdfDocument.Merge(pdf1, pdf2)

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

Ten kod pokazuje, jak łatwo można łączyć pliki PDF za pomocą IronPDF. Metoda PdfDocument.FromFile() ładuje istniejące pliki PDF do pamięci. Te załadowane dokumenty stają się obiektami PdfDocument, którymi można manipulować programowo.

Metoda Merge() pobiera co najmniej dwa obiekty PdfDocument i łączy je w jeden plik PDF. Strony z drugiego dokumentu są dołączane po stronach pierwszego dokumentu, zachowując oryginalną kolejność i formatowanie każdej strony.

Na koniec SaveAs() zapisuje scalony dokument na dysku. Powstały plik PDF zawiera wszystkie strony z obu dokumentów źródłowych w kolejności, gotowe do dystrybucji lub dalszego przetwarzania.

Jak połączyć wiele plików PDF jednocześnie?

W praktyce często trzeba połączyć więcej niż dwa dokumenty. IronPDF obsługuje ten scenariusz przy użyciu kolekcji List:

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

// Create a list to store PDF documents
var files = new List<PdfDocument>();

// Get all PDF files from a directory
string[] fileNames = Directory.GetFiles(@"C:\Reports\", "*.pdf");

// Load each PDF file
foreach (var fileName in fileNames)
{
    files.Add(PdfDocument.FromFile(fileName));
}

// Merge all PDFs into one
var merged = PdfDocument.Merge(files);

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

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

// Create a list to store PDF documents
var files = new List<PdfDocument>();

// Get all PDF files from a directory
string[] fileNames = Directory.GetFiles(@"C:\Reports\", "*.pdf");

// Load each PDF file
foreach (var fileName in fileNames)
{
    files.Add(PdfDocument.FromFile(fileName));
}

// Merge all PDFs into one
var merged = PdfDocument.Merge(files);

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

Imports IronPdf
Imports System.Collections.Generic
Imports System.IO

' Create a list to store PDF documents
Dim files As New List(Of PdfDocument)()

' Get all PDF files from a directory
Dim fileNames As String() = Directory.GetFiles("C:\Reports\", "*.pdf")

' Load each PDF file
For Each fileName In fileNames
    files.Add(PdfDocument.FromFile(fileName))
Next

' Merge all PDFs into one
Dim merged As PdfDocument = PdfDocument.Merge(files)

' Save the combined document
merged.SaveAs("CombinedReports.pdf")

Kod wykorzystuje Directory.GetFiles() do automatycznego wykrywania wszystkich plików PDF w określonym folderze, eliminując konieczność ręcznego wpisywania nazw poszczególnych plików. Zgodnie z dokumentacją Microsoftu dotyczącą operacji na plikach, metoda ta skutecznie pobiera ścieżki plików spełniające określone kryteria.

Każdy znaleziony plik PDF jest ładowany jako PdfDocument i dodawany do kolekcji List. Takie podejście sprawdza się równie dobrze, niezależnie od tego, czy łączysz trzy pliki, czy trzysta. Metoda Merge() przyjmuje całą listę, przetwarzając wszystkie dokumenty źródłowe w jednej operacji w celu utworzenia jednego nowego dokumentu.

Pętla foreach zapewnia przejrzysty sposób iteracji przez wiele plików PDF. W tym miejscu można dodać logikę filtrowania, aby wybrać konkretne pliki na podstawie wzorców nazewnictwa, dat lub innych kryteriów. Ten wzorzec sprawdza się dobrze w scenariuszach przetwarzania wsadowego, takich jak kompilacja raportów miesięcznych lub archiwizacja dokumentów.

Jak połączyć pliki PDF z różnych źródeł?

Czasami trzeba połączyć pliki PDF z różnych źródeł — na przykład scalając dynamicznie generowaną treść z istniejącymi szablonami. Oto jak IronPDF radzi sobie z tym wzorcem:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Create a PDF from HTML
string html = @"<h1>Cover Page</h1>
               <p>Example PDF From Multiple Sources</p>
               <div style='page-break-after: always;'></div>";
var coverPage = renderer.RenderHtmlAsPdf(html);

// Load an existing PDF report
var pdf = PdfDocument.FromFile("invoice.pdf");

// Create a summary from URL
var summary = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");

// Merge all three sources
var finalDocument = PdfDocument.Merge(new[] { coverPage, pdf, summary });

// Save the complete document
finalDocument.SaveAs("MultipleSources.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Create a PDF from HTML
string html = @"<h1>Cover Page</h1>
               <p>Example PDF From Multiple Sources</p>
               <div style='page-break-after: always;'></div>";
var coverPage = renderer.RenderHtmlAsPdf(html);

// Load an existing PDF report
var pdf = PdfDocument.FromFile("invoice.pdf");

// Create a summary from URL
var summary = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");

// Merge all three sources
var finalDocument = PdfDocument.Merge(new[] { coverPage, pdf, summary });

// Save the complete document
finalDocument.SaveAs("MultipleSources.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Create a PDF from HTML
Dim html As String = "<h1>Cover Page</h1>
                      <p>Example PDF From Multiple Sources</p>
                      <div style='page-break-after: always;'></div>"
Dim coverPage As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Load an existing PDF report
Dim pdf As PdfDocument = PdfDocument.FromFile("invoice.pdf")

' Create a summary from URL
Dim summary As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF")

' Merge all three sources
Dim finalDocument As PdfDocument = PdfDocument.Merge(New PdfDocument() {coverPage, pdf, summary})

' Save the complete document
finalDocument.SaveAs("MultipleSources.pdf")

Ten przykład pokazuje wszechstronność IronPDF w obsłudze różnych źródeł PDF. Klasa ChromePdfRenderer umożliwia konwersję HTML do PDF, co idealnie nadaje się do generowania dynamicznych stron tytułowych lub sformatowanych treści na podstawie danych z aplikacji. Renderer obsługuje nowoczesne standardy internetowe zgodnie ze specyfikacjami W3C.

Metoda RenderHtmlAsPdf() konwertuje ciągi znaków HTML bezpośrednio do formatu PDF, obsługując pełne style CSS i JavaScript. Metoda RenderUrlAsPdf() pobiera i konwertuje treści internetowe, co jest przydatne do włączania danych na żywo lub zasobów zewnętrznych. Więcej informacji można znaleźć w samouczku dotyczącym konwersji plików HTML do formatu PDF.

Łącząc te metody renderowania z istniejącymi dokumentami PDF, można tworzyć zaawansowane przepływy pracy z dokumentami. Takie podejście sprawdza się dobrze w sytuacjach takich jak dodawanie markowych stron tytułowych do raportów, dołączanie informacji prawnych do umów lub łączenie treści generowanych przez użytkowników z szablonami.

Jak porównać różne metody łączenia plików PDF?

Wybór odpowiedniej strategii scalania zależy od konkretnego scenariusza. Poniższa tabela podsumowuje trzy główne podejścia:

Każde podejście ma tę samą sygnaturę metody Merge(), więc przełączanie się między strategiami wymaga minimalnych zmian w kodzie. Dokumentacja API szczegółowo opisuje każde przeciążenie.

Jak dodać przetwarzanie po scaleniu do pliku PDF?

Po scaleniu wiele przepływów pracy wymaga dodatkowych operacji na poziomie dokumentu. IronPDF obsługuje je za pomocą przejrzystego, łańcuchowego interfejsu API:

using IronPdf;
using IronPdf.Editing;

var pdf1 = PdfDocument.FromFile("Report-January.pdf");
var pdf2 = PdfDocument.FromFile("Report-February.pdf");

var merged = PdfDocument.Merge(pdf1, pdf2);

// Add a text-based header across all pages
var headerStamper = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right;font-size:10px;'>Quarterly Report</div>"
};
merged.AddHtmlHeadersAndFooters(headerStamper);

// Apply password protection
merged.SecuritySettings.UserPassword = "YourPassword";
merged.SecuritySettings.OwnerPassword = "OwnerSecret";

// Save the final, protected document
merged.SaveAs("QuarterlyReport_Protected.pdf");

using IronPdf;
using IronPdf.Editing;

var pdf1 = PdfDocument.FromFile("Report-January.pdf");
var pdf2 = PdfDocument.FromFile("Report-February.pdf");

var merged = PdfDocument.Merge(pdf1, pdf2);

// Add a text-based header across all pages
var headerStamper = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right;font-size:10px;'>Quarterly Report</div>"
};
merged.AddHtmlHeadersAndFooters(headerStamper);

// Apply password protection
merged.SecuritySettings.UserPassword = "YourPassword";
merged.SecuritySettings.OwnerPassword = "OwnerSecret";

// Save the final, protected document
merged.SaveAs("QuarterlyReport_Protected.pdf");

Imports IronPdf
Imports IronPdf.Editing

Dim pdf1 = PdfDocument.FromFile("Report-January.pdf")
Dim pdf2 = PdfDocument.FromFile("Report-February.pdf")

Dim merged = PdfDocument.Merge(pdf1, pdf2)

' Add a text-based header across all pages
Dim headerStamper As New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='text-align:right;font-size:10px;'>Quarterly Report</div>"
}
merged.AddHtmlHeadersAndFooters(headerStamper)

' Apply password protection
merged.SecuritySettings.UserPassword = "YourPassword"
merged.SecuritySettings.OwnerPassword = "OwnerSecret"

' Save the final, protected document
merged.SaveAs("QuarterlyReport_Protected.pdf")

Ten wzorzec pokazuje, jak nakładać etapy przetwarzania końcowego na pojedynczy, scalony obiekt dokumentu. API nagłówków i stopek pozwala na spójne stosowanie elementów brandingowych, a ustawienia bezpieczeństwa chronią poufne dokumenty przed nieautoryzowanym dostępem. W tym samym procesie można również dodawać podpisy cyfrowe lub zapewnić zgodność z formatem PDF/A.

Jakie są kluczowe kwestie dotyczące łączenia plików PDF w .NET?

IronPDF przekształca zadanie łączenia plików PDF w środowisku .NET w proces wymagający minimalnej ilości kodu. Od prostych kombinacji dwóch plików po zaawansowane łączenie dokumentów z wielu źródeł — biblioteka radzi sobie ze złożonością techniczną, zapewniając jednocześnie intuicyjny interfejs API. Niezależnie od tego, czy pracujesz z pojedynczym plikiem, czy przetwarzasz duże partie dokumentów, IronPDF zachowuje integralność końcowego dokumentu podczas całego procesu scalania.

Przykłady w tym samouczku pokazują, jak zintegrować funkcje łączenia plików PDF z aplikacjami .NET. Niezależnie od tego, czy tworzysz systemy zarządzania dokumentami, automatyzujesz generowanie raportów, czy przetwarzasz pliki przesłane przez użytkowników, IronPDF zapewnia narzędzia potrzebne do wydajnego łączenia plików PDF z różnych źródeł.

Chcesz wdrożyć funkcję łączenia plików PDF w swoim projekcie? Zacznij od bezpłatnej wersji próbnej, aby poznać pełne możliwości IronPDF. W przypadku wdrożeń produkcyjnych zapoznaj się z opcjami licencyjnymi, które najlepiej odpowiadają Twoim potrzebom. Pełna dokumentacja obejmuje zaawansowane funkcje, takie jak dodawanie znaków wodnych, stosowanie zabezpieczeń i dzielenie dokumentów PDF.