MSG 檔案（常由 Microsoft Outlook 使用）會儲存電子郵件訊息以及其附件、收件者和中繼資料。雖然標準附件會將內容直接嵌入電子郵件中，參考附件則會連結到外部檔案，例如網路共享文件或網路託管的資源。
在本文中，您將學習如何使用 Aspose.Email for .NET 在 MSG 檔案中處理參考附件。我們將介紹如何以程式方式在 C# 中 識別、讀取和新增 參考附件。此方法對於有效管理大型檔案以及動態連結外部資源至關重要。
Aspose.Email for .NET: 處理 MSG 檔案和附件
Aspose.Email for .NET 是為 .NET 開發人員提供的專用電子郵件處理 API。它提供讀取、建立和修改 MSG 檔案的功能，並支援處理附件、行事曆以及 IMAP、POP3、SMTP、EWS 和 Microsoft Graph 等電子郵件協議。
在處理 MSG 檔案中的參考附件時，Aspose.Email 簡化了檢測、提取和新增這些附件等任務。開發人員無需手動解析 MSG 結構或依賴 Outlook，即可使用 API 存取 MAPI 屬性、取得外部檔案連結，並以程式方式操作電子郵件內容。
要開始使用 Aspose.Email for .NET，您可以使用以下命令透過 NuGet 安裝：
PM> Install-Package Aspose.Email
一旦整合到您的專案中，您就可以利用 API 以結構化且高效的方式處理 MSG 檔案和附件，提升 C# 應用程式的電子郵件管理能力。
如何識別 MSG 檔案中的參考附件
在 MSG 檔案中，可以使用 IsReference 屬性（屬於 MapiAttachment 類）來識別參考附件。與標準附件不同，這些是指向外部檔案的指標，而不是嵌入的物件。以下程式碼範例將示範如何在 MSG 檔案中偵測參考附件。它會載入 MSG 檔案，並檢查每個附件的 IsReference 屬性，讓您能相應地處理基於參考的附件。
步驟:
- 使用 MapiMessage.Load 方法提供檔案名稱來載入 Outlook 訊息。
- 迭代
msg.Attachments集合中所有的附件。 - 使用
attachment.IsReference屬性檢查目前的附件是否為參考附件。 - 如果附件是參考附件，列印訊息指出偵測到參考附件，並顯示其顯示名稱。
程式碼範例：
讀取參考附件的屬性
參考附件是根據 PidTagAttachMethod MAPI 屬性，透過 IsReference 屬性以及其檔案路徑或網路連結來判定的。以下是表示參考附件的關鍵值：
- 0x00000002 - afByReference: 附件透過完整的檔案路徑識別，收件人在具有共享檔案伺服器存取權限的情況下可取得。
- 0x00000004 - afByReferenceOnly: 附件僅以其完整的檔案路徑識別。
- 0x00000007 - afByWebReference: 附件透過網路連結識別，並由 PidNameAttachmentProviderType 指定處理該附件的 Web 服務 API。
如果附件不符合這些條件，則 IsReference 屬性返回 False。
若要提取參考附件的詳細資訊，包括原始 URL，請使用以下方法：
在此範例中：
- AttachmentOriginalUrl 取得原始的網路連結，如果附件是以網路 URL 參照的話。
- AttachmentProviderType 表示處理附件的 Web 服務 API。
- AttachLongPathname 提供完整的檔案路徑，如果附件是以檔案路徑參照的話。
- AttachMethod 回傳附件的方式，協助判斷參照類型。
使用此方法，您可以通過讀取屬性並訪問其外部內容（無論是網路連結還是檔案路徑），有效地處理參考附件。
在 MSG 檔案中添加參考附件
您可以使用 MapiAttachmentCollection.Add 方法添加參考附件，該方法包含一個用於添加參考附件的重載，並使用 ReferenceAttachmentOptions 類別，該類別允許您指定附件的 URL、提供者連結以及提供者類型等詳細資訊。此方法允許您在不嵌入內容的情況下指定外部檔案或網路連結。
以下是將參考附件添加到 MSG 檔案的方法：
此 ReferenceAttachmentOptions 建構函式接受三個參數：
- Attachment URL: 直接指向參考檔案的連結。
- Provider link: 網路服務或檔案提供者的 URL。
- Provider type: 指定處理附件的網路服務 API 的字串（例如 “GoogleDrive”）。
然後，MapiAttachmentCollection.Add 方法會新增一個名為 “Document.pdf” 的參考附件，並使用指定的選項。
使用此方法，您可以在 MSG 訊息中包含對外部檔案或網路連結的參考，而不直接嵌入內容，使您的訊息更輕量且更具彈性。
結論
在本文中，我們探討了如何使用 Aspose.Email for .NET 管理 MSG 檔案中的參考附件。我們介紹了識別參考附件、提取其屬性以及以程式方式新增附件的方法。與標準附件不同，參考附件會連結到外部資源，從而減少電子郵件的大小並提升可存取性。
通過將這些功能整合到您的 .NET 應用程式中，您可以高效地處理大型檔案、維護動態內容，並優化電子郵件儲存。無論是自動化電子郵件工作流程，還是管理 MSG 檔案中的外部連結，Aspose.Email for .NET 都提供靈活且強大的解決方案。
欲取得更多資源，請查看以下內容：
- API Reference – 探索可用類別和方法的詳細文件。
- Developer Guide – 一步一步的教學與程式碼範例，協助您快速入門。
- Support Forum – 提出問題、分享見解，並從社群獲得協助。
- Blog – 隨時了解最新功能、最佳實踐與教學。