Jak dodawać i usuwać załączniki PDF w języku C# za pomocą IronPDF

Jakie typy plików można dołączyć do pliku PDF?

IronPDF obsługuje dołączanie praktycznie każdego typu pliku do dokumentów PDF. Typowe typy załączników to:

• Dokumenty pakietu Office (DOCX, XLSX, PPTX)
• Obrazy (JPG, PNG, GIF, SVG)
• Pliki tekstowe (TXT, CSV, XML)
• Archiwa (ZIP, RAR)
• Inne pliki PDF

System załączników obsługuje dane binarne, więc można załączyć każdy plik, który można odczytać jako bajty. Podczas pracy z określonymi typami dokumentów warto również rozważyć wbudowane funkcje konwersji IronPDF, takie jak konwersja plików DOCX do formatu PDF lub konwersja obrazów do formatu PDF.

Gdzie pojawiają się załączniki w przeglądarkach plików PDF?

Różne przeglądarki plików PDF wyświetlają załączniki w różnych miejscach:

• Adobe Acrobat: Wyświetla ikonę spinacza w panelu nawigacyjnym
• Przeglądarka PDF w Chrome: po kliknięciu wyświetla załączniki w lewym pasku bocznym
• Przeglądarka PDF w przeglądarce Firefox: Wyświetla załączniki w dedykowanym panelu
• Microsoft Edge: Podobna do przeglądarki Chrome, z widokiem załączników w pasku bocznym

Większość nowoczesnych przeglądarek plików PDF obsługuje załączniki, choć interfejs może się nieco różnić w zależności od aplikacji.

Co dzieje się z obiektem PdfAttachment po dodaniu?

Kiedy wywołasz AddAttachment(), IronPDF tworzy obiekt PdfAttachment, który zawiera:

• Nazwa: Nazwa wyświetlana załącznika
• Dane: zawartość binarna załączonego pliku
• Opis: Opcjonalne metadane dotyczące załącznika

Ten obiekt jest dodawany do wewnętrznej kolekcji załączników PDF i pozostaje dostępny przez właściwość Attachments, dopóki explicitnie nie zostanie usunięty.

Attachments

Jak uzyskać dostęp do wielu załączników w pliku PDF?

Właściwość Attachments zwraca kolekcję, przez którą można iterować lub przeprowadzać zapytania za pomocą LINQ:

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

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

' Get all attachments as a list
Dim allAttachments = pdf.Attachments.ToList()

' Filter attachments by size (e.g., files larger than 1MB)
Dim largeAttachments = pdf.Attachments _
    .Where(Function(a) a.Data.Length > 1024 * 1024) _
    .ToList()

' Find specific attachment by exact name
Dim specificAttachment = pdf.Attachments _
    .FirstOrDefault(Function(a) a.Name = "report.xlsx")

Jakie właściwości są dostępne dla pobranych załączników?

Każdy obiekt PdfAttachment zapewnia:

• Name: Nazwa wyświetlana załącznika
• Data: Zawartość binarna jako tablica bajtów
• Description: Opcjonalne dane metadane opisu (jeśli ustawione)

Możesz użyć tych właściwości do identyfikacji, filtrowania i przetwarzania załączników zgodnie z własnymi wymaganiami.

Jak mogę filtrować załączniki według nazwy lub typu?

Ponieważ załączniki są przechowywane wraz z ich nazwami wyświetlanymi, można je filtrować za pomocą operacji na ciągach znaków:

// 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();

// 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();

' Filter by file extension (assuming names include extensions)
Dim imageAttachments = pdf.Attachments _
    .Where(Function(a) a.Name.EndsWith(".jpg") OrElse _
                   a.Name.EndsWith(".png") OrElse _
                   a.Name.EndsWith(".gif")) _
    .ToList()

' Filter by name pattern
Dim reportsOnly = pdf.Attachments _
    .Where(Function(a) a.Name.StartsWith("Report_")) _
    .ToList()

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Co się stanie, gdy usunę załącznik?

Po usunięciu załącznika:

1. Dane załącznika zostały całkowicie usunięte z pliku PDF
2. Rozmiar pliku zmniejsza się mniej więcej o rozmiar usuniętego załącznika
3. Wszelkie odniesienia do tego załącznika w strukturze pliku PDF zostały usunięte
4. Zmiana jest trwała po zapisaniu pliku PDF

Jest to podobne do innych operacji modyfikacji plików PDF, takich jak usuwanie stron lub redagowanie treści.

Czy mogę usunąć wiele załączników jednocześnie?

Tak, można usunąć wiele załączników w ramach jednej operacji. Oto przykład:

// 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());
}

// 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());
}

Imports System.Linq

' Remove all attachments that match a pattern
Dim attachmentsToRemove = pdf.Attachments _
    .Where(Function(a) a.Name.StartsWith("temp_")) _
    .ToList()

For Each attachment In attachmentsToRemove
    pdf.Attachments.RemoveAttachment(attachment)
Next

' Or remove all attachments at once
While pdf.Attachments.Count > 0
    pdf.Attachments.RemoveAttachment(pdf.Attachments.First())
End While

Jak sprawdzić, czy załącznik został pomyślnie usunięty?

Możesz sprawdzić usunięcie załączników na kilka sposobów:

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

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

' Check the attachment count
Dim attachmentCountBefore As Integer = pdf.Attachments.Count
pdf.Attachments.RemoveAttachment(targetAttachment)
Dim attachmentCountAfter As Integer = pdf.Attachments.Count

' Verify the count decreased
If attachmentCountAfter < attachmentCountBefore Then
    Console.WriteLine("Attachment successfully removed")
End If

' Check if specific attachment exists
Dim attachmentExists As Boolean = pdf.Attachments _
    .Any(Function(a) a.Name = "specificFile.txt")