如何使用IronPDF在 C# 中新增和刪除 PDF 附件

我可以將哪些文件類型附加到 PDF 文件中？

IronPDF支援將幾乎任何類型的文件附加到 PDF 文件。 常見的附著類型包括：

• 辦公室文件(DOCX、XLSX、PPTX)
• 圖片(JPG、PNG、GIF、SVG)
• 文字檔案(TXT、CSV、XML)
• 壓縮檔案(ZIP、RAR) 其他PDF文件

附件系統使用二進位數據，因此任何可以作為位元組讀取的檔案都可以作為附件。 處理特定文件類型時，您也可以考慮 IronPDF 內建的轉換功能，例如將 DOCX 轉換為 PDF或將影像轉換為 PDF 。

PDF 閱讀器中附件顯示在哪裡？

不同的PDF閱讀器會將附件顯示在不同的位置：

• Adob​​e Acrobat ：在導覽窗格中顯示回形針圖標
• Chrome PDF 檢視器：點擊後在左側邊欄顯示附件
• Firefox PDF 檢視器：在專用面板中顯示附件
• Microsoft Edge ：與 Chrome 類似，帶有側邊欄附件視圖

大多數現代 PDF 檢視器都支援附件，儘管不同應用程式的介面可能略有不同。

新增後，PdfAttachment 物件會發生什麼變化？

當您呼叫 AddAttachment() 時， IronPDF會建立一個包含以下內容的PdfAttachment物件： -名稱：附件的顯示名稱 -資料：附件檔案的二進位內容 -描述：關於附件的可選元數據

該物件被添加到 PDF 的內部附件集合中，並且一直可以透過 Attachments 屬性訪問，直到顯式刪除為止。

如何存取PDF中的多個附件？

Attachments屬性傳回一個集合，您可以使用 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");

已檢索附件有哪些屬性？

每個PdfAttachment物件提供： -名稱：附件的顯示名稱 -資料：二進位內容，以位元組數組形式存儲 -描述：可選的描述元資料(如果設定)

您可以利用這些屬性，根據您的需求識別、篩選和處理附件。

如何依名稱或類型篩選附件？

由於附件是與其顯示名稱一起儲存的，因此您可以使用字串操作來篩選它們：

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

移除附件會發生什麼事？

移除附件時：

1. PDF 檔案中的附件資料已完全刪除
2. 檔案大小減少的量大約等於移除的附件的大小。
3. 清除PDF結構中對該附件的所有引用。
4. 儲存PDF文件後，變更將永久生效。

這與其他 PDF 修改操作(例如刪除頁面或編輯內容)類似。

我可以一次刪除多個附件嗎？

是的，您可以一次移除多個附件。 舉個例子：

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

如何確認附件已成功刪除？

您可以透過以下幾種方式驗證附件是否已刪除：

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