vCard，即虛擬聯系人文件 (VCF)，是一種廣泛使用的文件格式，用于存儲和共享聯系人信息。它允許個人和組織在各種平臺和設備上以標準化且易于閱讀的格式交換聯系人詳細信息。VCF 文件可以存儲各種聯系信息，包括姓名、地址、電話號碼、電子郵件地址甚至照片。

由于其靈活性和兼容性，VCF 已成為數字名片、電子郵件簽名和聯系人管理系統的熱門選擇。無論您是管理個人使用的聯系人還是將聯系人數據集成到更大的系統中，了解如何使用 vCard 文件都將非常有用。

Aspose.Email 是用于輕松的開發 email 功能的應用程序的一組控件，基于  ASP.NET 的Web應用、Web服務和Windows 應用。支持 Outlook PST, EML, MSG, and MHT 格式. 允許開發者直接與 SMTP, POP, FTP, 和 MS Exchange 服務器進行工作。支持郵件合并、行事歷、定制郵件標題和內容、嵌入文件等，Aspose API支持流行文件格式處理，并允許將各類文檔導出或轉換為固定布局文件格式和最常用的圖像/多媒體格式。

Aspose.Email 最新下載

使用 C# API 管理電子郵件文件

為了以編程方式處理個人信息記錄，我們將使用Aspose.Email for .NET。它是一個強大的庫，旨在管理和處理各種格式和協議的電子郵件數據。它支持廣泛的功能，包括電子郵件創建、操作、轉換和發送，以及處理不同的郵件存儲格式，如 PST、OST、MBOX 和 EML。開發人員可以使用它來輕松創建、編輯和轉換 vCard 文件。該庫允許提取個人信息、管理多個條目，并確保與不同版本的格式兼容，而不會產生任何復雜性。利用該庫首先要將其集成到您的項目中。最簡單的方法是通過 NuGet 包管理器：

• 在 Visual Studio 中打開您的項目。
• 導航到工具>NuGet 包管理器>管理解決方案的 NuGet 包。
• 搜索Aspose.Email。
• 選擇包并單擊“安裝”。

或者，您可以使用包管理器控制臺并輸入以下命令：

Install-Package Aspose.Email

創建 vCard 文件

創建 vCard 文件涉及初始化新的 vCard 對象、向其填充聯系人信息以及將其保存到文件中。在本節中，我們將介紹使用 C# 創建 VCF 的步驟，介紹基本組件并提供示例實現。

初始化新的 vCard 對象：首先創建VCardContact類的新實例。此對象將作為您希望包含的所有聯系人信息的容器。
設置聯系信息：使用相關詳細信息（如全名、電子郵件地址、電話號碼、送貨地址等）填充VCardContact對象。使用FullName和EmailAddress等屬性來設置這些詳細信息。
將 vCard 保存到文件：設置完所有聯系信息后，您可以將VCardContact對象保存到文件。指定文件路徑并選擇適當的VCardSaveOptions（如 vCard 版本）。
下面是一個完整的示例，演示了如何使用上面概述的所有步驟創建 vCard 文件：

// Initialize a new vCard object
var contact = new VCardContact
{
IdentificationInfo =
{
// Set contact information
FullName = new VCardFullName
{
GivenName = "Jane",
FamilyName = "Smith",
MiddleName = "B",
HonorificPrefixes = "Ms."
}
}
};

// Add email addresses
contact.Emails.Add(new VCardEmail
{
EmailAddress = "jane.smith@example.com",
EmailType = VCardEmailType.INTERNET
});

// Add telephone numbers
contact.TelephoneNumbers.Add(new VCardTelephoneNumber
{
TelephoneNumber = "987-654-3210",
TelephoneType = VCardTelephoneType.WORK
});

// Add delivery addresses
contact.DeliveryAddresses.Add(new VCardDeliveryAddress
{
Street = "456 Elm St",
Locality = "Othertown",
Region = "TX",
PostalCode = "67890",
CountryName = "USA",
AddressType = VCardDeliveryAddressType.WORK
});

// Add explanatory information
contact.ExplanatoryInfo = new VCardExplanatoryInfo
{
Note = "Jane's contact information",
Uid = "unique-id-5678"
};

// Save the vCard to a file
var saveOptions = new VCardSaveOptions()
{
Version = VCardVersion.V30
};

contact.Save("jane_smith.vcf", saveOptions);

加載 vCard 文件

從 VCF 加載數據涉及從 VCF 文件中讀取信息并將其解析為應用程序中可用的格式。此過程允許您檢索和處理存儲在 VCF 文件中的信息，從而實現顯示聯系人詳細信息或更新現有記錄等功能。在本節中，我們將介紹使用 C# 從 VCF 文件加載數據的步驟，包括如何處理多個聯系人以及檢查單個 VCF 中是否存在多個條目。

從 VCF 文件加載

要從 VCF 加載單個條目，通常使用Load方法。此方法讀取文件并將其內容解析為VCardContact對象。

1. 調用 Load 方法：使用VCardContact.Load方法從 VCF 文件中讀取 vCard 數據。
2. 訪問聯系人詳細信息：加載后，您可以訪問VCardContact對象的各種屬性來檢索聯系人詳細信息。

這是一個完整的例子：

// Load a single vCard from a file
var contact = VCardContact.Load("contact.vcf");

// After loading the vCard, you can access its properties to retrieve contact details:
var fullName = contact.IdentificationInfo.FullName.ToString();
var emailAddress = contact.Emails[0].EmailAddress;
var phoneNumber = contact.TelephoneNumbers[0].TelephoneNumber;

從包含多個聯系人的 VCF 文件加載

在某些情況下，單個 VCF 文件可能包含多個 vCard。要處理此類文件，您首先需要檢查它們是否包含多個聯系人，然后相應地加載它們。

1. 檢查多個聯系人：使用方法確定文件是否包含多個聯系人。
2. 加載多個聯系人：如果是，請使用方法從文件讀取并解析所有聯系人。
3. 處理每個聯系人：遍歷聯系人列表并根據需要進行處理。

這是一個完整的例子：

// Check if the file contains multiple contacts
var isMultiContactFile = VCardContact.IsMultiContacts("contacts.vcf");

if (isMultiContactFile)
{
// Load multiple contacts from the file
var contacts = VCardContact.LoadAsMultiple("contacts.vcf");

foreach (var contact in contacts)
{
// Process each contact
var fullName = contact.IdentificationInfo.FullName.ToString();
var emailAddress = contact.Emails[0].EmailAddress;
var phoneNumber = contact.TelephoneNumbers[0].TelephoneNumber;
// Additional processing here
}
}
else
{
// Handle a single contact file
var contact = VCardContact.Load("contact.vcf");
// Process the single contact
var fullName = contact.IdentificationInfo.FullName.ToString();
var emailAddress = contact.Emails[0].EmailAddress;
var phoneNumber = contact.TelephoneNumbers[0].TelephoneNumber;
}

vCard 照片處理

在本節中，我們將介紹如何將照片保存為單獨的圖像，然后將其添加到現有的 vCard 條目中。

將 vCard 照片保存為單獨的圖像文件

要將 vCard 照片保存為單獨的圖像文件，請按照以下步驟操作：

1. 加載 vCard 聯系人：使用方法加載包含照片的 vCard。
2. 提取照片數據：訪問屬性以檢索照片數據及其類型。
3. 保存照片數據到文件：根據照片類型使用適當的格式將照片數據寫入圖像文件。

以下是一個例子：

// Load photo data from a vCard contact (if applicable)
var contact = VCardContact.Load("contact.vcf");
var photoData = contact.IdentificationInfo.Photo.Data;
var photoType = contact.IdentificationInfo.Photo.PhotoType;

// Specify the path and format for the image file
string imagePath = "saved_photo.jpg";

// Save the photo data to the image file
if (photoType == VCardPhotoType.JPEG)
{
File.WriteAllBytes(imagePath, photoData);
}

將 vCard 照片添加到 vCard 聯系人

要將保存的照片添加到現有的 vCard 條目，請按照以下步驟操作：

1. 加載已保存的照片數據：從圖像文件中讀取照片數據。
2. 創建一個新的 vCard 照片對象：使用照片數據和類型初始化
3. 將照片分配給 vCard 聯系人：設置對象的屬性。

以下是一個例子：

// Load the saved photo data
var photoData = File.ReadAllBytes("saved_photo.jpg");

// Create a new vCard photo object
var photo = new VCardPhoto
{
Data = photoData,
PhotoType = VCardPhotoType.JPEG // Specify the photo format
};

// Load or create a vCard contact
var contact = VCardContact.Load("contact.vcf");

// Add the photo to the contact
contact.IdentificationInfo.Photo = photo;

將 vCard 保存到 Outlook MSG 文件

將 vCard 保存為 Outlook MSG 文件格式涉及將 vCard 數據轉換為 Outlook 兼容格式。MSG 文件格式是一種專有格式，用于存儲電子郵件、日歷事件和聯系人。在本節中，我們將探討如何將 vCard 條目保存為 MSG 格式。要執行此任務，只需按照以下步驟操作：

1. 加載或創建 vCard 聯系人：首先或。此條目將保存為 MSG 格式。
2. 準備 MSG 格式的保存選項：創建以指定應以 MSG 格式保存條目。
3. 將 vCard 聯系人保存到 MSG 文件：使用配置的保存選項將個人數據

這是一個完整的示例，演示如何將 vCard 聯系人保存到 Outlook MSG 文件：

// Load or create a vCard contact
var contact = VCardContact.Load("contact.vcf");

// Save the contact as an MSG file
contact.Save

("contact.msg", new MapiContactSaveOptions());

結論

在 C# .NET 中管理 vCard 文件提供了強大的處理個人信息功能，使您能夠靈活高效地處理聯系人數據。在本文中，我們探討了 vCard 管理的各個方面，從創建和保存 vCard 文件到加載聯系人和處理照片。

Aspose.Email for .NET 通過提供強大的工具來輕松處理 vCard 文件，增強了這些功能。無論您是開發聯系人管理系統、電子郵件客戶端還是其他相關應用程序，使用 Aspose.Email for .NET 都可以讓您以編程方式管理 vCard 數據，從而大大增強軟件的功能和用戶體驗。

歡迎下載|體驗更多Aspose文檔管理產品 

獲取更多信息請咨詢慧都在線客服 或 加入Aspose技術交流群（666790229）