如何添加和移除 PDF 附件

喬迪·巴迪亞

2023年9月11日

已更新 2024年12月17日

Translated

View the article in English

PDF 文件中的附件是指嵌入在 PDF 文件本身內的文件或額外數據。這與PDF的常規內容不同，常規內容在您查看PDF時包括可見的文字、圖像和格式設定。這些附件可以是各種檔案類型，包括圖片、文件、試算表或其他格式。通常，附件用於提供額外的參考資料或補充數據，用戶在打開PDF時可以訪問這些資料。

在IronPDF中處理附件時，過程簡單且對用戶友好。

如何添加和移除 PDF 附件

從 NuGet 下載 IronPDF 的 C# 程式庫
載入現有的PDF或渲染新的PDF
使用 File.ReadAllBytes 方法將要附加的檔案匯入為 byte[]
使用AddAttachment方法將其附加到PDF
使用RemoveAttachment方法從PDF移除附件

新增附件示例

要將檔案新增為附件，首先在您的程式中以byte []加載它。最簡單的方法是使用File.ReadAllBytes方法。透過將檔案載入為byte []，然後可以使用AddAttachment方法將物件作為附件添加到PDF中，如下所示：

:path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-add-attachment.cs

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

Imports IronPdf
Imports System.IO

' Import attachment file
Private fileData() As Byte = File.ReadAllBytes("path/to/file")

' Open existing PDF
Private pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

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

pdf.SaveAs("addAttachment.pdf")

$vbLabelText $csharpLabel

AddAttachment 函數輸出一個 PdfAttachment 物件，我們可以保留作為未來參考，或在需要時將其移除。

儲存PDF後，您可以從PDF查看器的工具欄打開附件。我們在下面的圖片中展示如何在Google Chrome的PDF查看器中找到此功能：

附件預覽

從那裡，您可以點擊它並將附件保存到您自己的存儲空間。

檢索附件範例

可以通過訪問 PdfDocument 對象的 Attachments 屬性將 PDF 中的附件作為二進位資料檢索。使用二進制數據，您可以將 PDF 中的附件匯出為各自的檔案格式。

:path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-retrieve-attachment.cs

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

Imports IronPdf
Imports System.IO

' Open existing PDF
Private pdf As PdfDocument = PdfDocument.FromFile("addAttachment.pdf")

' Iterate through all attachments
For Each attachment In pdf.Attachments
	If attachment.Name.Contains("Example") Then
		' Save byte to file
		File.WriteAllBytes($"{attachment.Name}.doc", attachment.Data)
	End If
Next attachment

$vbLabelText $csharpLabel

刪除附件示例

若要移除附件，只需使用RemoveAttachment函數。此方法需要引用附件，可以從Attachments屬性中檢索。我們展示如何使用上面保存的文件來做到這一點。

:path=/static-assets/pdf/content-code-examples/how-to/add-remove-attachments-remove-attachment.cs

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

Imports IronPdf
Imports System.Linq

' Open existing PDF
Private pdf As PdfDocument = PdfDocument.FromFile("addAttachment.pdf")

' Add attachment to the PDF
Private retrieveAttachments As PdfAttachmentCollection = pdf.Attachments

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

pdf.SaveAs("removeAttachment.pdf")

$vbLabelText $csharpLabel

刪除附件並在 PDF 檢視器中開啟生成的檔案後，可以看到附件不再出現：

附件預覽

喬迪·巴迪亞

立即與工程團隊聊天

軟體工程師

Jordi 最擅長 Python、C# 和 C++，當他不在 Iron Software 發揮技能時，他會進行遊戲編程。他負責產品測試、產品開發和研究，為持續產品改進增添了巨大的價值。多樣化的經驗使他感到挑戰和投入，他說這是與 Iron Software 合作的最喜歡的方面之一。Jordi 在佛羅里達州邁阿密長大，並在佛羅里達大學學習計算機科學和統計學。