在專業應用中處理聯絡人資料通常需要在不同格式之間進行轉換。一個常見的情境是將 Outlook 聯絡人轉換為適合在瀏覽器中預覽或分享的 Web 友好格式,然後再將其內容轉回 VCF 格式以便儲存或重複使用。
本文示範如何在 C# 中使用 Aspose.Email for .NET 函式庫執行這些轉換。
以先進的 .NET API 為您的聯絡人轉換提供動力
Aspose.Email for .NET 是一個功能強大的庫,使開發人員能夠建立、操作和轉換 Outlook 檔案(MSG、PST、OST)、電子郵件、行事曆項目、通訊組清單等。在本文中,我們將使用它來轉換:
- Outlook VCF 連絡人轉換為 HTML 文件
- HTML 內容轉換為 MapiContact 物件
開始使用
首先使用 NuGet 套件管理員將庫安裝到您的專案中:
- 在 Visual Studio 中打開您的專案。
- 前往 Tools > NuGet Package Manager > Manage NuGet Packages for Solution。
- 搜索 Aspose.Email。
- 選取套件並點擊 Install。
或者,您可以透過 Package Manager Console 使用以下命令安裝套件:
Install-Package Aspose.Email
您也可以直接從 Aspose 網站下載最新版本的 API。
安裝完成後,您就可以開始使用了。
匯出 VCF 聯絡人為 HTML
Aspose.Email 允許將 VCF 檔案載入為 MapiContact,然後匯出為顯示友好的版面,並可自訂選項,例如包含 vCard 詳細資訊和標頭。以下程式碼範例示範如何將 VCF 匯出為 HTML:
- 使用 FromVCard() 方法讀取 .vcf 檔案並建立 MapiContact 物件。
- 在 MapiContact 上呼叫 GetUnderlyingMessage(),將其轉換為 MailMessage 物件以便進一步匯出。
- 設定 HtmlSaveOptions 以控制匯出資料的格式:
- 使用 RenderVCardInfo 包含 vCard 特定細節。
- 使用 WriteHeader 添加標準的電子郵件樣式標頭。
將 HTML 內容匯入 VCF 聯絡人
您也可以從 HTML 字串產生新的 Outlook 連絡人,並將其儲存為 VCF 檔案。當個人資料透過網頁表單收集或編輯,或從網頁範本匯入時,這非常有用。以下程式碼範例示範如何從 HTML 建立連絡人:
- 將 HTML 檔案的內容載入為字串。
- 使用顯示名稱和電子郵件地址初始化 MapiContact。
- 使用 SetBodyContent() 將載入的內容指派給聯絡人,並指定內容類型為 BodyContentType.Html。
- 使用 ContactSaveFormat.VCard 格式將結果儲存為 .vcf 檔案。
結論
我們探討了 Aspose.Email for .NET 函式庫在電子郵件管理中的其中一項擴充功能。您學會了如何將聯絡人與 HTML 之間相互轉換,以提升互通性、實現更簡易的自訂,並在顯示個人資訊時提供更佳的使用者體驗。使用我們的 API,您只需幾行程式碼即可處理這些任務,並完全掌控格式設定。
其他資源
為了幫助您充分利用 API,請查看以下資源:
