IronPDF ile ASP.NET C#'ta PDF Nasıl Oluşturulur

IronPDF'ye Nasıl Başlanır?

Herhangi bir birleştirme kodu yazmadan önce, IronPDF'yi NuGet üzerinden kurun. Paket, .NET Framework 4.6.2+ ve .NET 5/6/7/8/9/10 hedefliyor, bu yüzden konsol uygulamalarında, ASP.NET Core hizmetlerinde, Azure Fonksiyonlarında ve Windows Forms projelerinde ek çalışma zamanı bağımlılıkları olmadan çalışıyor.

NuGet Paket Yöneticisi Konsolu'nu açın ve şunu çalıştırın:

Install-Package IronPdf

Veya .NET CLI kullanın:

dotnet add package IronPdf

Lisans anahtarını uygulama dahil olmak üzere adım adım kurulum için IronPDF kurulum genel bakışına bakın. Paket kurulup lisans anahtarı uygulandıktan sonra, bu kılavuzdaki her örnek değişiklik yapılmadan çalışacaktır.

PDF Belgeleri Programlı Olarak Nasıl Birleştirilir?

PdfDocument.Merge yöntemi, iki PDF dosyasını tek bir PDF olarak birleştirmenin en doğrudan yolunu sağlar. Her kaynak belgeyi PdfDocument.FromFile ile yükleyin, her iki nesneyi Merge'a aktarın ve sonucu kaydedin.

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

Birden Fazla PDF Dosyasını Aynı Anda Nasıl Birleştirirsiniz?

İkiden fazla belgenin birleştirilmesi gerektiğinde, aşırı yüklenmiş Merge yöntemine bir List<PdfDocument> (veya herhangi bir IEnumerable<PdfDocument>) aktarın. Bu yöntem üç dosyadan yüzlerce dosyaya kadar kod yapınızı değiştirmeden ölçeklenir.

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 Kullanarak PDF Dosyalarını Nasıl Birleştirirsiniz?

Disk yazımının mümkün olmadığı veya çok yavaş olduğu web hizmetleri ve sunucusuz fonksiyonlar için bellekte işleme gereklidir. IronPDF, byte dizilerinden PDF belgelerini yüklemeyi destekler ve birleştirilmiş sonucu Stream özelliği aracılığıyla bir MemoryStream olarak sunar.

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

Birleştirilmiş Dosyalarda Yer İşaretleri ve Gezinme Nasıl Korunur?

Bir PDF dosyalarını birleştirirken, IronPDF her kaynak belgenin yer işareti yapısını taşır. Okuyucular, birleşmiş çıktının gezinme panelinde tüm birleştirilmiş dosyalardan tam içindekiler tablosunu görür, bu da kullanıcıların farklı kaynak belgelerden gelen bölümler arasında atlamasını kolaylaştırır. PDF spesifikasyonuindeki yer işaretleri, belge anahat sözlüğünde saklanır ve IronPDF, tüm birleşmiş kaynaklar için bu yapıyı doğru bir şekilde yeniden oluşturur.

Yer işareti koruma, ekstra yapılandırma gerekmeden otomatik olarak gerçekleşir. Kaynak dosyalar bölüm ve alt bölümler için iç içe yer işaretleri içeriyorsa, hiyerarşi birleşmiş çıktıda korunur. Birleşmiş belgeler için ayrı ayrı belge yer işareti ağaçları yerine birlik içindekiler tablosuna ihtiyaç duyan belgeler için, içindekiler tablosu API'si, birleştirmeden sonra özel bir gezinme yapısı oluşturmanıza olanak tanır.

Kaynak belge yer işareti verisi olmadan oluşturulmuşsa, birleşmiş çıktıda bu bölüm için herhangi bir anahat girişi olmayacaktır. Uyumluluk veya arşiv bağlamında birleştirilmiş bir dosyayı teslim etmeden önce, elde edilen PdfDocument üzerinde OutlineManager özelliğini inceleyerek hangi yer işaretlerinin taşındığını doğrulayın. Programlı olarak yer işareti etiketlerini yeniden adlandırabilir, girişlerin sırasını yeniden düzenleyebilir veya farklı kaynak belgelerden gelen içeriği mantıklı bir hiyerarşiye bağlayan yeni öğeler ekleyebilirsiniz. Ayrıca uzun süreli arşivleme için PDF/A dönüşümüne ihtiyaç duyan iş akışları için, her kaynağa ayrı ayrı değil birleşmiş belgenin sonunda uyum adımını uygulayın. Son birleşmiş belgeyi tek bir geçişte dönüştürmek daha etkilidir ve daha fazla düzenlemeye gereksinim duyabilecek çıktıları yeniden dönüştürmekten kaçınır.

Birleştirdikten sonra, birden fazla kaynaktan elde edilen onlarca sayfayı kapsayan çıktılarda yararlı olan sayfa numaralandırma özelliği kullanarak birleştirilmiş belgeye sayfa numaraları da ekleyebilirsiniz.

Birleşmiş PDF'ye Parola Koruması Nasıl Uygulanır?

Birleştirme işleminden sonra, elde edilen PdfDocument kullanıcı ve sahip şifreleri uygulamak, yazdırma, kopyalama ve düzenleme haklarını kısıtlamak için SecuritySettings sağlar.

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 okuyucuları belgeyi görüntülemeden önce uyarırken, OwnerPassword izin değişikliklerini sınırlar. Parola korumasını baskı kısıtlamaları, kopya önleme bayrakları ve dijital imzalarla birleştirebilirsiniz. Tüm izin seçeneklerinin tam açıklaması için, PDF güvenlik kılavuzu mevcut tüm ayarları kapsar.

Kaynak belgeler kendileri parola korumasına sahipse, sahip belgelerine sahipseniz şifrelenmiş PDF'leri birleştirmeden önce IronPDF de-şifreleyebilir. Bu, manuel kilitleme işlemleri olmadan farklı satıcılar veya sistemlerden gelen güvenli belgeleri tek bir yeniden güvenli çıktı haline getirebileceğiniz anlamına gelir.

Birleşmiş PDF'nin Dosya Boyutu Nasıl Azaltılır?

Birçok resim içeren büyük belgeleri birleştirmek, saklamak veya göndermek için büyük sonuçlar üretebilir. IronPDF'nin PDF sıkıştırma API'si, katman içindeki gömülü resimleri daha düşük kalitede yeniden sıkıştırarak dosya boyutunu önemli ölçüde azaltabilirken metin keskinliğini korur.

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 için tam sayı argümanı bir kalite yüzdesidir: 50 ile 75 arasındaki değerler genellikle metin içeriğine görünür bir bozulma olmaksızın, görüntü ağırlıklı belgelerde dosya boyutunu %40-70 oranında azaltır. Vektör grafikleri içeren ve minimum raster görüntülere sahip belgeler için tasarruflar daha azdır, ancak çağrının güvenle dahil edilmesi her durumda zararsızdır.

PDF Birleştirme için Yaygın Kullanım Durumları Nelerdir?

PdfDocument.Merge API, .NET uygulamalarında üretim aşamasındaki geniş bir belge iş akışına uygundur:

Belgelerin seçici olarak çıkarılması gerektiği iş akışları için, PDF bölme API'si bir kaynak belgeden belirli sayfa aralıklarını çıkarabilir. Tek birleştirme çıktısında yalnızca büyük bir belgenin belirli kısımlarının görünmesi gerektiğinde, PDF dosyaları arasında sayfa kopyalama doğrudan yapabilirsiniz.

IronPDF, birleştirilmiş belgelerden metin ve resimlerin düşey işlemesi için de destek sunar, bu da onu daha büyük veri hatları içinde merkezi bir doküman oluşturma adımı olarak uygundur.

Sonraki Adımlarınız Neler?

IronPDF'in PdfDocument.Merge yöntemi, iki dosya birleşimi, çok dosyalı liste birleşimi, bellek içi işlem, şifre korumalı çıktılar ve birleştirme sonrası sıkıştırma ile kapsamlı .NET PDF birleştirme senaryolarını minimum kodla kapsar. Her yöntem, giriş kaynak türü ne olursa olsun aynı tutarlı API'yi kullanır.

Ücretsiz deneme başlat ve bu örnekleri kendi projenizde çalıştırın. Üretim dağıtımı için, ekibinizin büyüklüğüne ve kullanımına uygun lisanslama seçeneklerine bakın.

Birleştirme desteği eklendikten sonra ilgili belge işlemlerini keşfedin: çok sayfalı bir PDF'yi ayrı dosyalara ayırma, çok sayfalı çıktılara sayfa numarası ekleme veya tüm sayfalara filigran uygulama.

Şimdi IronPDF ile başlayın.

Ücretsiz Başlayın