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

IronPDF 可讓您使用 AddAttachment() 和 RemoveAttachment() 等簡單的 C# 方法，以程式化的方式在 PDF 文件中新增、擷取和移除檔案附件，讓您可以直接將輔助檔案嵌入 PDF 中。

<！--說明：說明程式碼概念的圖表或截圖 -->

PDF 文件中的附件是指嵌入在 PDF 文件本身中的文件或附加資料。 這與 PDF 的常規內容不同，常規內容包括查看 PDF 時可見的文字、圖像和格式。 這些附件可以採用各種文件類型，包括圖像、文件、電子表格或其他格式。 通常，附件用於提供用戶開啟 PDF 時可以存取的其他參考資料或補充資料。 當建立全面的 PDF 報告或需要將多個 PDF 文件與支援文件合併時，此功能尤其有用。

快速入門：為 PDF 新增附件

使用 IronPDF 為您的 PDF 文件添加附件。 這個簡單的範例示範如何將文件作為附件嵌入到 PDF 中。 載入您現有的 PDF，使用 AddAttachment 方法，並儲存更新後的文件。 此流程可確保您的輔助資料包含在 PDF 中，使其可直接從任何 PDF 檢視器存取。

如何將檔案新增為 PDF 的附件？ 若要將檔案新增為附件，請先以 `byte[]` 的方式載入。 最簡單的方法是使用`File.ReadAllBytes`方法。 將檔案載入為 **byte[]**，使用 `AddAttachment` 方法將物件新增為 PDF 的附件： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-add-attachment.cs ``` `AddAttachment` 函式會輸出一個 **PdfAttachment** 物件，您可以保留此物件以備日後參考，或在需要時移除。 這種方法類似於 [ 將圖片新增至 PDF](https://ironpdf.com/how-to/add-images-to-pdfs/) 或 [ 管理其他 PDF 資產](https://ironpdf.com/how-to/background-foreground/)。 儲存 PDF 檔案後，您可以從 PDF 檢視器的工具列開啟附件。 下圖展示了在 Google Chrome 的 PDF 檢視器中找到此功能的位置： ！[PDF 檢視器顯示具有導覽控制項和側欄面板的 Hello World 文件](/static-assets/pdf/how-to/add-remove-attachments/attachment-example.png)。 從那裡，您可以點選並儲存附件到您的儲存空間。

我可以將哪些檔案類型附加到 PDF？ IronPDF 支援將幾乎任何檔案類型附加到 PDF 文件。 常見的附件類型包括 - 辦公室文件 (DOCX、XLSX、PPTX) - 圖片 (JPG, PNG, GIF, SVG) - 文字檔（TXT、CSV、XML） - 檔案 (ZIP, RAR) - 其他 PDF 附件系統可使用二進位資料，因此任何可讀取為位元組的檔案都可以附加。 在處理特定的文件類型時，您也可以考慮 IronPDF 內建的轉換功能，例如 [ 將 DOCX 轉換為 PDF](https://ironpdf.com/how-to/docx-to-pdf/) 或 [ 將影像轉換為 PDF](https://ironpdf.com/how-to/image-to-pdf/)。

附件在 PDF 檢視器中何處出現？ 不同的 PDF 檢視器會在不同的位置顯示附件： - **Adobe Acrobat**：在導覽窗格中顯示迴紋針圖示 - **Chrome PDF Viewer**：點選時在左側邊欄顯示附件 - **Firefox PDF Viewer**：在專屬面板中顯示附件 - **Microsoft Edge**：類似 Chrome，具有側邊欄附件檢視功能 大多數現代的 PDF 檢視器都支援附件，不過不同應用程式的介面可能會略有不同。

新增後 PdfAttachment 物件會發生什麼變化？ 當您呼叫 `AddAttachment()` 時，IronPDF 會建立一個 **PdfAttachment** 物件，其中包含： - **名稱**：附件的顯示名稱 - **資料**：所附檔案的二進制內容 - **說明**：關於附件的可選元資料 此物件會新增至 PDF 的內部附件集合，並透過 `Attachments` 屬性維持存取，直到被明確移除為止。

如何從現有的 PDF 擷取附件？ 透過存取 **PdfDocument** 物件的 **Attachments** 屬性，可以將 PDF 中的附件擷取為二進位資料。 利用二進位數據，您可以將 PDF 中的附件匯出為相應的文件格式。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-retrieve-attachment.cs ``` 當您需要[從 PDF 中萃取內容](https://ironpdf.com/how-to/extract-text-and-images/)或以程式化的方式處理附加的文件時，此程序尤其有用。

如何存取 PDF 中的多個附件？ **Attachments** 屬性會返回一個集合，您可以遍歷該集合或使用 LINQ 進行查詢： ```csharp // 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** 物件提供： - **名稱**：附件的顯示名稱 - **資料**：以位元組陣列顯示的二進位內容 - **說明**：可選的描述元資料 (如果已設定) 您可以根據需求使用這些屬性來識別、過濾和處理附件。

如何依名稱或類型篩選附件？ 由於附件會以顯示名稱儲存，因此您可以使用字串操作來過濾附件： ```csharp // 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(); ```

---

如何從 PDF 移除附件？ 若要移除附件，請使用 `RemoveAttachment` 函式。 此方法需要對附件的引用，可以從**Attachments**屬性中檢索該引用。 以下是如何使用上面儲存的檔案來完成： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-remove-attachment.cs ``` 刪除附件後，用 PDF 檢視器開啟產生的文件，你會發現附件不再顯示： 。

當我移除附件時會發生什麼事？ 當您移除附件時： 1.從 PDF 檔案中完全移除附件資料 2.檔案大小大約會因移除附件的大小而減少 3.清理 PDF 結構中對該附件的任何引用 4.一旦您儲存 PDF，該變更即為永久性 這與其他 PDF 修改作業類似，例如 [ 移除頁面](https://ironpdf.com/how-to/add-copy-delete-pages-pdf/) 或 [ 節錄內容](https://ironpdf.com/how-to/redact-text/)。

我可以一次移除多個附件嗎？ 是的，您可以在一次操作中移除多個附件。 以下是一個範例： ```csharp // 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()); } ```

如何驗證附件已成功移除？ 您可以透過幾種方式驗證附件的移除： ```csharp // 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 附件的最佳實務 在 IronPDF 中處理 PDF 附件時，請考慮這些最佳實務： 1.**檔案大小管理**：請注意附件的大小，因為它們會直接增加 PDF 檔案的大小。 2.**命名慣例**：為附件使用清楚、具描述性的名稱，以協助使用者識別這些附件 3.**安全考量**：處理敏感附件時，請考慮應用 [ IronPDF 密碼和權限](https://ironpdf.com/how-to/pdf-permissions-passwords/)。 4.**效能**：對於大型附件或許多檔案，請考慮使用 [async 作業](https://ironpdf.com/how-to/async/)，以維持應用程式的回應能力 準備好看看您還能做些什麼嗎？ 請查看我們的教學頁面：[整理PDF文件](https://ironpdf.com/tutorials/organize-pdfs-complete-tutorial/)