IRONSOFTWAREHOME

IronPDF ile C#'te PDF Eklerini Ekleme ve Kaldırma

Curtis Chau
Curtis Chau
Updated: 22 Nisan 2026

IronPDF, ek dosyaları PDF belgelerine kodla eklemenizi, almanızı ve kaldırmanızı sağlar. AddAttachment() ve RemoveAttachment() gibi basit C# yöntemleri kullanarak, tamamlayıcı dosyaları doğrudan PDF'lerinize gömebilirsiniz.

PDF belgesindeki ekler, PDF dosyasının kendisine gömülmüş dosyalara veya ek verilere atıfta bulunur. Bu, PDF'yi görüntülediğinizde görünen metin, resim ve formatlamayı içeren normal PDF içeriğinden farklıdır. Bu ekler genellikle resimler, belgeler, e-tablolar veya diğer formatlar dahil olmak üzere çeşitli dosya türlerinde olabilir. Genellikle ekler, kullanıcıların PDF açıldığında erişebilecekleri ek referans materyalleri veya ek veriler sağlamak için kullanılır. Bu yetenek, özellikle kapsamlı PDF raporları oluşturmak veya birden fazla PDF'yi destekleyici belgelerle birleştirmek gerektiğinde faydalıdır.

Hızlı Başlangıç: PDF'ye Ek Ekleme

IronPDF kullanarak PDF belgelerinize ekler ekleyin. Bu hızlı örnek, bir dosyayı PDF'ye ek olarak nasıl gömeteceğinizi gösterir. Mevcut PDF'inizi yükleyin, AddAttachment yöntemini kullanın ve güncellenmiş belgeyi kaydedin. Bu süreç, ek materyallerinizin PDF'nizle birlikte eklendiğinden emin olur, onları doğrudan herhangi bir PDF görüntüleyicisinden erişilebilir kılar.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Bu kod parçacığını kopyalayın ve çalıştırın.

    var pdf = IronPdf.PdfDocument.FromFile("example.pdf");
    pdf.Attachments.AddAttachment("file.txt", System.IO.File.ReadAllBytes("file.txt"));
    pdf.SaveAs("updated.pdf");
    C#
  3. 3Canlı ortamınızda test için dağıtım yapın

    Ücretsiz deneme ile bugün projenizde IronPDF kullanmaya başlayın
    arrow pointer

Bir Dosyayı PDF'ye Nasıl Ek Olarak Eklerim?

Bir dosyayı ek olarak eklemek için önce onu byte[] olarak yükleyin. Bunu yapmanın en kolay yolu File.ReadAllBytes yöntemini kullanmaktır. Dosyayı byte[] olarak yükledikten sonra, nesneyi ek olarak bir PDF'e eklemek için AddAttachment yöntemini kullanın:

using IronPdf;
using System.IO;

// Import attachment file
byte[] fileData = File.ReadAllBytes(@"path/to/file");

// Open existing PDF
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Add attachment to the PDF
pdf.Attachments.AddAttachment("Example", fileData);

pdf.SaveAs("addAttachment.pdf");

AddAttachment fonksiyonu, gelecekte başvuru için saklayabileceğiniz veya gerekirse sonra kaldırabileceğiniz bir PdfAttachment nesnesi oluşturur. Bu yaklaşım, PDF'lere resim eklemek veya diğer PDF varlıklarını yönetmek ile benzerdir.

PDF'yi kaydettikten sonra, PDF görüntüleyicinin araç çubuğundan eki açabilirsiniz. Aşağıdaki resim, bu özelliği Google Chrome'un PDF Görüntüleyicisinde nerede bulacağınızı gösterir:

Gezinme kontrolleri ve yan panel ile Hello World belgesini gösteren PDF görüntüleyici

Buradan üzerine tıklayarak eki depolama alanınıza kaydedebilirsiniz.

Hangi Dosya Türlerini Bir PDF'ye Ek Olarak Ekleyebilirim?

IronPDF, neredeyse her türlü dosya türünü PDF belgelerine eklemeyi destekler. Yaygın ek türleri şunları içerir:

  • Ofis belgeleri (DOCX, XLSX, PPTX)
  • Resimler (JPG, PNG, GIF, SVG)
  • Metin dosyaları (TXT, CSV, XML)
  • Arşivler (ZIP, RAR)
  • Diğer PDF'ler

Ek sistemi ikili verilerle çalışır, bu nedenle bayt olarak okunabilen herhangi bir dosya eklenebilir. Belirli belge türleriyle çalışırken, IronPDF'in yerleşik dönüşüm özelliklerini de göz önünde bulundurabilirsiniz, örneğin DOCX'i PDF'ye dönüştürmek veya resimleri PDF'ye dönüştürmek

Ekler PDF Görüntüleyicilerde Nerede Görünür?

Farklı PDF görüntüleyiciler ekleri çeşitli konumlarda gösterir:

  • Adobe Acrobat: Gezinti penceresinde bir ataş simgesi gösterir
  • Chrome PDF Görüntüleyici: Tıklandığında ekleri sol yan panelde görüntüler
  • Firefox PDF Görüntüleyici: Ekleri özel bir panelde gösterir
  • Microsoft Edge: Chrome'a benzer şekilde, bir kenar çubuğu ek görünümü vardır

Çoğu modern PDF görüntüleyici ekleri destekler, ancak arayüz uygulamalardan uygulamalara biraz farklılık gösterebilir.

Bir Ek Ekledikten Sonra PdfAttachment Nesnesine Ne Olur?

AddAttachment() çağırdığınızda, IronPDF, şunları içeren bir PdfAttachment nesnesi oluşturur:

  • Ad: Ekin gösterim adı
  • Veri: Eklenmiş dosyanın ikili içeriği
  • Açıklama: Ek hakkında isteğe bağlı metadata

Bu nesne, PDF'in dahili ek koleksiyonuna eklenir ve açıkça kaldırılana kadar Attachments özelliği aracılığıyla erişilebilir kalır.

Attachments

Mevcut Bir PDF'den Ekleri Nasıl Alabilirim?

Bir PDF içerisindeki ekler, PdfDocument nesnesinin Attachments özelliğine erişilerek ikili veri olarak alınabilir. İkili verilerle, ekleri PDF'den kendi dosya formatları olarak dışa aktarabilirsiniz.

using IronPdf;
using System.IO;

// Open existing PDF
PdfDocument pdf = PdfDocument.FromFile("addAttachment.pdf");

// Iterate through all attachments
foreach (var attachment in pdf.Attachments)
{
    if (attachment.Name.Contains("Example"))
    {
        // Save byte to file
        File.WriteAllBytes($"{attachment.Name}.doc", attachment.Data);
    }
}

Bu süreç, PDF'lerden içerik çıkarma veya programlı olarak ekli belgeleri işleme gereği duyduğunuzda özellikle faydalıdır.

Bir PDF'deki Birden Fazla Eke Nasıl Erişim Sağlarım?

Attachments özelliği, LINQ kullanarak üzerinde yineleme yapabileceğiniz veya sorgulayabileceğiniz bir koleksiyon döndürür:

// Get all attachments as a list
var allAttachments = pdf.Attachments.ToList();

// Filter attachments by size (e.g., files larger than 1MB)
var largeAttachments = pdf.Attachments
    .Where(a => a.Data.Length > 1024 * 1024)
    .ToList();

// Find specific attachment by exact name
var specificAttachment = pdf.Attachments
    .FirstOrDefault(a => a.Name == "report.xlsx");

Alınan Ekler Üzerindeki Hangi Özellikler Mevcuttur?

Her PdfAttachment nesnesi sunar:

  • Name: Ekin görüntüleme adı
  • Data: Bayt dizisi olarak ikili içerik
  • Description: İsteğe bağlı açıklama meta verisi (atanmışsa)

Bu özellikleri kullanarak ekleri tanımlayabilir, filtreleyebilir ve gereksinimlerinize göre işleyebilirsiniz.

Ekleri İsim veya Tiplere Göre Nasıl Filtreleyebilirim?

Ekler gösterim adlarıyla saklandığı için, string işlemleri kullanarak onları filtreleyebilirsiniz:

// Filter by file extension (assuming names include extensions)
var imageAttachments = pdf.Attachments
    .Where(a => a.Name.EndsWith(".jpg") || 
                a.Name.EndsWith(".png") || 
                a.Name.EndsWith(".gif"))
    .ToList();

// Filter by name pattern
var reportsOnly = pdf.Attachments
    .Where(a => a.Name.StartsWith("Report_"))
    .ToList();

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

PDF'den Ekleri Nasıl Kaldırırım?

Bir eki kaldırmak için RemoveAttachment fonksiyonunu kullanın. Bu yöntem, ek ile ilgili bir referans gerektirir ve bu referans Attachments özelliğinden alınabilir. Bunu, yukarıda kaydedilmiş dosyayı kullanarak nasıl yapacağınızı gösteririz:

using IronPdf;
using System.Linq;

// Open existing PDF
PdfDocument pdf = PdfDocument.FromFile("addAttachment.pdf");

// Add attachment to the PDF
PdfAttachmentCollection retrieveAttachments = pdf.Attachments;

// Remove attachment from PDF
pdf.Attachments.RemoveAttachment(retrieveAttachments.First());

pdf.SaveAs("removeAttachment.pdf");

Eki kaldırdıktan ve ortaya çıkan dosyayı bir PDF görüntüleyicisine açtıktan sonra, ekin artık görünmediğini göreceksiniz.

Eki paneli açık olan PDF görüntüleyici, Hello World belgesini ve Ekleri Göster düğmesini gösteriyor

Bir Eki Kaldırdığımda Ne Olur?

Bir eki kaldırdığınızda:

  1. Ek verileri PDF dosyasından tamamen kaldırılır Dosya boyutu, kaldırılan ekin boyutu kadar azalır
  2. PDF yapısındaki bu eke referanslar temizlenir
  3. Değişiklik, PDF'yi kaydettiğinizde kalıcı hale gelir

Bu, diğer PDF düzenleme operasyonlarına benzer, sayfaları kaldırmak veya içerik sansürü gibi.

Birden Fazla Eki Aynı Anda Kaldırabilir miyim?

Evet, tek seferde birden fazla ek kaldırabilirsiniz. İşte bir örnek:

// Remove all attachments that match a pattern
var attachmentsToRemove = pdf.Attachments
    .Where(a => a.Name.StartsWith("temp_"))
    .ToList();

foreach (var attachment in attachmentsToRemove)
{
    pdf.Attachments.RemoveAttachment(attachment);
}

// Or remove all attachments at once
while (pdf.Attachments.Count > 0)
{
    pdf.Attachments.RemoveAttachment(pdf.Attachments.First());
}

Bir Ekin Başarıyla Kaldırıldığını Nasıl Doğrularım?

Birçok şekilde ek kaldırmayı doğrulayabilirsiniz:

// Check the attachment count
int attachmentCountBefore = pdf.Attachments.Count;
pdf.Attachments.RemoveAttachment(targetAttachment);
int attachmentCountAfter = pdf.Attachments.Count;

// Verify the count decreased
if (attachmentCountAfter < attachmentCountBefore)
{
    Console.WriteLine("Attachment successfully removed");
}

// Check if specific attachment exists
bool attachmentExists = pdf.Attachments
    .Any(a => a.Name == "specificFile.txt");

PDF Ekleri için En İyi Uygulamalar

IronPDF'de PDF ekleriyle çalışırken şu en iyi uygulamaları göz önünde bulundurun:

  1. Dosya Boyutu Yönetimi: Ek boyutlarına dikkat edin, çünkü bunlar doğrudan PDF dosyası boyutunu artırır
  2. Adlandırma Kuralları: Kullanıcıların ekleri tanımlamalarını sağlamak için açık, açıklayıcı adlar kullanın
  3. Güvenlik Düşünceleri: Hassas eklerle çalışırken PDF parolaları ve izinleri uygulamayı düşünün
  4. Performans: Büyük ekler veya birçok dosya için, uygulama tepki yeteneğini korumak amacıyla async işlemlerini kullanmayı düşünün

Başka neler yapabileceğinizi görmek için hazır mısınız? Derli toplu Öğretici sayfamızı kontrol edin: PDF'leri Düzenleyin

Sıkça Sorulan Sorular

C# dilinde bir PDF'ye programlı olarak nasıl dosya eklerim?

IronPDF, dosyaları PDF'lere gömmek için basit bir AddAttachment() yöntemi sağlar. Önce dosyanızı bir bayt dizisi olarak File.ReadAllBytes() kullanarak yükleyin, ardından PdfDocument nesnenizdeki AddAttachment yöntemini kullanın. Yöntem dosya adını ve bayt dizisini parametre olarak alır.

PDF'lere hangi tür dosyalar eklenebilir?

IronPDF, resimler, belgeler, hesap tabloları ve diğer formatlar dahil olmak üzere PDF'lere çeşitli dosya türlerini eklemenize olanak sağlar. Bu ekler, PDF dosyasına doğrudan gömülür ve herhangi bir standart PDF görüntüleyicisinin ek paneli aracılığıyla erişilebilir.

Ek eklemek için mevcut bir PDF'yi nasıl yüklerim?

IronPDF'nin PdfDocument.FromFile() yöntemini kullanarak mevcut bir PDF'yi yükleyebilirsiniz. Yüklendikten sonra, Ekler özelliğini kullanarak ekleri yönetebilir, AddAttachment() ile yeni ekler ekleyebilir veya var olanları kaldırabilirsiniz.

PDF içeriği ile PDF ekleri arasındaki fark nedir?

PDF içeriği, PDF'yi görüntülerken gördüğünüz metin, resimler ve biçimlendirmeyi içerir. Ekler, ana belge görünümünde görünmeyen PDF içindeki ayrı dosyalardır. IronPDF ile ekler, PDF görüntüleyicisinin ek paneli aracılığıyla erişilir ve tamamlayıcı materyaller olarak hizmet eder.

Bir PDF'den ekleri nasıl kaldırabilirim?

IronPDF, PDF'lerden programlı olarak gömülmüş dosyaları kaldırmak için bir RemoveAttachment() yöntemi sağlar. AddAttachment işlevi, ileride yapılacak kaldırma işlemleri için referans olarak kullanabileceğiniz bir PdfAttachment nesnesi döndürür.

Kullanıcılar bir PDF görüntüleyicisinde ekleri nerede bulabilir?

IronPDF kullanarak ekleri ekledikten sonra kullanıcılar, PDF görüntüleyicisinin araç çubuğu aracılığıyla onlara erişebilir. Google Chrome'un yerleşik görüntüleyicisi dahil çoğu PDF görüntüleyici, gömülü dosyaların açılabileceği veya kaydedilebileceği bir ek simgesi veya paneli gösterir.

Is it possible to filter PDF attachments by type or name in IronPDF?

Yes, you can filter attachments using the `Attachments` collection based on file extensions or specific name patterns.

What are the best practices for managing PDF attachments in IronPDF?

Some best practices include managing file sizes, using descriptive naming conventions, securing sensitive content with passwords, and leveraging asynchronous operations for better performance.

How can I verify if an attachment was successfully removed?

You can verify attachment removal by checking the number of attachments before and after removal or confirming the absence of the specific attachment by name in the `Attachments` collection.

What happens to the PDF file size when attachments are removed using IronPDF?

Removing attachments with IronPDF reduces the file size roughly by the size of the attachment, as the attachment data is completely removed from the PDF file.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...
Daha Fazla Oku

Başlamaya Hazır mısınız?

Nuget Downloads 20,756,830Sürüm:2026.7yeni yayınlandı

ÜCRETSİZİNİZİ EDİNİN

30 günlük Deneme Anahtarınızı anında edinin.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmez
bullet_testÜretimde Test
filigran olmadan
bullet_calendar30 gün tamamen
işlevsel ürün
bullet_supportDeneme sırasında teknik
24/5 destek
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez
PDF için C# NuGet Kütüphanesi
NuGet ile yükleyin

Sürüm: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Çözüm Gezgini'nde Referanslar'a sağ tıklayın, NuGet Paketlerini Yönet
  2. Tarayıcıya tıklayın ve "IronPdf" arayın
  3. Paketi seçin ve yükleyin
C# PDF DLL
DLL İndir

Sürüm: 2026.7

veya Windows Yükleyiciyi şuradan buradan indirin.

  1. IronPDF'i, ~/Libs gibi bir yere, Solution dizininiz içinde indirin ve açın.
  2. Visual Studio Çözüm Gezgini'nde, Referanslar'a sağ tıklayın. Tarayıcı sekmesini seçin, "IronPdf.dll"

Lisanslar $999

Key in blue circle

Ücretsiz 30 günlük Deneme Anahtarınızı anında edinin.

Your trial license will be sent to your email address

Herhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmezHerhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Ücretsiz Canlı Demo rezervasyonu yapın
Booking Badge

Dünya Çapında Milyonlarca Mühendisin Güvendiği

Iron Software müşteri logoları
Bağımsız Danışmanlık Alın
Aşağıdaki formu doldurun veya sales@ironsoftware.com adresine e-posta gönderin
Bilgileriniz daima gizli kalacaktır.
Dünya Çapında Milyonlarca Mühendisin Güvendiği
Iron Software müşteri logoları
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez