以編程方式管理電子郵件數(shù)據(jù)可能很復(fù)雜，尤其是在處理消息應(yīng)用程序編程接口 (MAPI) 屬性時。這些屬性是與 MAPI 對象（例如消息、文件夾、收件人和消息系統(tǒng)中的其他組件）關(guān)聯(lián)的屬性或元數(shù)據(jù)。

這些屬性提供有關(guān)對象的詳細(xì)信息，例如電子郵件的主題、發(fā)件人的地址、電子郵件的發(fā)送日期等。MAPI 屬性廣泛用于電子郵件客戶端和其他消息應(yīng)用程序中，以管理和操作電子郵件數(shù)據(jù)。本文深入探討了使用Aspose.Email for .NET訪問、枚舉和操作 MAPI 屬性的各種技術(shù)。

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

Aspose.Email 最新下載   

.NET API 在 C# 中管理 MAPI 屬性

Aspose.Email for .NET為處理消息應(yīng)用程序編程接口屬性提供全面支持，允許開發(fā)人員通過詳細(xì)控制管理和操作電子郵件數(shù)據(jù)。它也是一個廣泛的 API，允許開發(fā)人員為其電子郵件應(yīng)用程序配備強大的消息處理和其他相關(guān)任務(wù)功能。

使用 Aspose.Email for .NET，開發(fā)人員可以創(chuàng)建復(fù)雜的電子郵件管理和處理解決方案。要開始使用該庫，您可以從 Aspose 網(wǎng)站或它并將其集成到您的項目中。

MAPI 屬性的類別

確保您的項目中已安裝 Aspose.Email，然后我們就開始吧。MAPI 屬性可分為三種主要類型：標(biāo)準(zhǔn)屬性、命名屬性和自定義（用戶定義）屬性。每種類別都有不同的用途，并為使用電子郵件數(shù)據(jù)的開發(fā)人員提供不同程度的靈活性和控制力。以下是每種類型的概述：

標(biāo)準(zhǔn)屬性

它們由 MAPI 規(guī)范定義，具有預(yù)定義的屬性標(biāo)簽，通常用于消息傳遞對象的標(biāo)準(zhǔn)屬性。例如：

• ：消息的主題。
• ：發(fā)件人的姓名。
• ：傳遞原始消息的日期和時間。

命名屬性

這些屬性由 GUID 和字符串名稱或整數(shù)標(biāo)識符標(biāo)識，可以實現(xiàn)比標(biāo)準(zhǔn)屬性更具體的分類和識別。

自定義（用戶定義）屬性

它們由開發(fā)人員定義，擴展了 MAPI 對象的功能，允許定制和特定于應(yīng)用程序的數(shù)據(jù)處理。

列出所有 MAPI 屬性

要列出消息中的所有 MAPI 屬性，我們將使用方法來加載消息并遍歷其屬性。下面的代碼示例演示了如何使用 Aspose.Email for .NET 加載 MAPI 消息、遍歷其屬性以及打印有關(guān)每個屬性的詳細(xì)信息：

1. 從指定路徑加載 MAPI 消息文件。
2. 遍歷msg.Properties.Values集合來訪問每個屬性。
3. 對于每個 MAPI 屬性，打印出其標(biāo)簽、規(guī)范名稱和數(shù)據(jù)類型：
   • 標(biāo)簽屬性為 MAPI 屬性提供唯一標(biāo)識符。
   • Descriptor.CanonicalName屬性給出了屬性的人類可讀的名稱。
   • Descriptor.DataType屬性指示該屬性的數(shù)據(jù)類型。

// Load the email message from a file
var msg = MapiMessage.Load(@"D:\Aspose\Files\msg\test.msg");

// Iterate through all MAPI properties and print their details
foreach (var mapiProperty in msg.Properties.Values)
{
Console.WriteLine($"Tag: {mapiProperty.Tag}");
Console.WriteLine($"Canonical Name: {mapiProperty.Descriptor.CanonicalName}");
Console.WriteLine($"Data Type: {mapiProperty.Descriptor.DataType}");
}

列出命名的 MAPI 屬性

常規(guī) MAPI 屬性由包含屬性類型和屬性標(biāo)識符的 16 位屬性標(biāo)記標(biāo)識，而命名屬性則由 GUID 和字符串名稱或整數(shù)標(biāo)識符的組合標(biāo)識：

• GUID（全局唯一標(biāo)識符）：唯一標(biāo)識符，保證屬性集的唯一性。這個GUID通常由開發(fā)者提供。
• 姓名或身份證號：
  • 字符串名稱（區(qū)分大小寫）。
  • 32 位整數(shù)標(biāo)識符。

以下代碼片段演示了如何使用 Aspose.Email for .NET 遍歷消息的命名 MAPI 屬性并根據(jù)屬性描述符類型打印出詳細(xì)信息：

1. 對象的“NamedProperties.Values”集合來遍歷每個命名屬性，以獲取所有命名的 MAPI 屬性。
2. 檢查當(dāng)前命名屬性的 Descriptor 是否為類型。如果是，則將 Descriptor 轉(zhuǎn)換為 PidNamePropertyDescriptor。打印出屬性的 GUID、規(guī)范名稱和數(shù)據(jù)類型。
3. 檢查當(dāng)前命名屬性的 Descriptor 是否為類型。如果是，則將 Descriptor 轉(zhuǎn)換為 PidLidPropertyDescriptor。打印出屬性的 GUID、規(guī)范名稱、長 ID 和數(shù)據(jù)類型。

foreach (MapiNamedProperty mapiNamedProperty in msg.NamedProperties.Values)
{
if (mapiNamedProperty.Descriptor is PidNamePropertyDescriptor pidNamePropertyDescriptor)
{
Console.WriteLine($"GUID: {pidNamePropertyDescriptor.PropertySet}");
Console.WriteLine($"Canonical Name: {pidNamePropertyDescriptor.CanonicalName}");
Console.WriteLine($"Data Type: {pidNamePropertyDescriptor.DataType}");
}

if (mapiNamedProperty.Descriptor is PidLidPropertyDescriptor pidLidPropertyDescriptor)
{
Console.WriteLine($"GUID: {pidLidPropertyDescriptor.PropertySet}");
Console.WriteLine($"Canonical Name: {pidLidPropertyDescriptor.CanonicalName}");
Console.WriteLine($"Long ID: {pidLidPropertyDescriptor.LongId}");
Console.WriteLine($"Data Type: {pidLidPropertyDescriptor.DataType}");
}
}

因此，我們根據(jù)描述符類型（或）打印了特定的屬性PropertySet，如CanonicalName、、DataType和。LongIdPidNamePropertyDescriptorPidLidPropertyDescriptor

通過描述符檢索屬性

 通過描述符檢索屬性是一種訪問特定 MAPI 屬性的直接方法，無需遍歷整個屬性集合。Aspose.Email for .NET 提供了一種使用 KnownPropertyList 檢索屬性的便捷方法下面的代碼示例演示了如何檢索和打印特定屬性（如 InternetMessageId，如果存在）的詳細(xì)信息。

1. 使用對象的 Properties 集合訪問屬性。
2. 驗證該屬性不為空以確保它存在于消息中。
3. 打印檢索到的屬性的詳細(xì)信息：標(biāo)簽、規(guī)范名稱和數(shù)據(jù)類型。
4. 如果屬性數(shù)據(jù)類型是字符串，請使用方法檢索屬性值并打印它。

// Retrieve and print the InternetMessageId property if it exists
if (msg.Properties[KnownPropertyList.InternetMessageId] != null)
{
var property = msg.Properties[KnownPropertyList.InternetMessageId];
Console.WriteLine($"Tag: {property.Tag}");
Console.WriteLine($"Canonical Name: {property.Descriptor.CanonicalName}");
Console.WriteLine($"Data Type: {property.Descriptor.DataType}");

// Retrieve and print the property value if it is a string
if (property.Descriptor.DataType == PropertyDataType.String)
{
var propertyValue = property.GetString();
Console.WriteLine($"Value: {propertyValue}");
}
}

通過標(biāo)簽檢索屬性

屬性標(biāo)記是唯一標(biāo)識 MAPI 屬性的 32 位標(biāo)識符。它由屬性 ID 和屬性類型組成。使用屬性標(biāo)記，您可以直接訪問 MAPI 消息中的特定屬性。下面的代碼示例演示了如何檢索和打印特定屬性（如 PR_HASATTACH，如果存在）的詳細(xì)信息。

1. 使用對象的 Properties 集合訪問 PR_HASATTACH 屬性。
2. 驗證該屬性不為空以確保它存在于消息中。
3. 打印檢索到的屬性的詳細(xì)信息：標(biāo)簽和數(shù)據(jù)類型。
4. 如果屬性數(shù)據(jù)類型為布爾值，則使用方法來檢索屬性值并打印消息是否帶有附件。

// Retrieve and print the PR_HASATTACH property if it exists
if (msg.Properties[MapiPropertyTag.PR_HASATTACH] != null)
{
var property = msg.Properties[MapiPropertyTag.PR_HASATTACH];
Console.WriteLine($"Tag: {property.Tag}");
Console.WriteLine($"Data Type: {property.DataType}");

// Retrieve and print the property value if it is a boolean
if (property.DataType == (int)MapiPropertyType.PT_BOOLEAN)
{
var propertyValue = property.GetBoolean();
Console.WriteLine($"Has Attachments: {propertyValue}");
}
}

使用 GetProperty 方法

方法簡化了從 MAPI 消息中檢索常規(guī)屬性和命名屬性的過程。此方法允許您通過其描述符或標(biāo)記直接訪問屬性，而無需手動檢查屬性集合。以下代碼示例演示了如何利用 GetProperty 方法訪問特定的 MAPI 屬性：

1. 使用方法從類直接訪問屬性。
2. 驗證該屬性不為空以確保它存在于消息中。
3. 使用方法檢索屬性值并打印它。

// Retrieve and print the CurrentVersionName property
var namedProperty = msg.GetProperty(KnownPropertyList.CurrentVersionName);
if (namedProperty != null)
{
Console.WriteLine($"Current Version Name: {namedProperty.GetString()}");
}

這里，GetProperty用于CurrentVersionName直接訪問屬性。

使用自定義屬性

自定義 MAPI 屬性是附加屬性，不屬于預(yù)定義的 MAPI 屬性集。它們用于保存特定于應(yīng)用程序的數(shù)據(jù)，由開發(fā)人員定義。通過允許開發(fā)人員定義和使用附加屬性，MAPI 提供了一種靈活而強大的方法來存儲和管理消息應(yīng)用程序中的自定義數(shù)據(jù)。自定義屬性是命名屬性（使用 GUID 和字符串名稱）。Aspose.Email 引入了一種方法，您可以使用它來獲取消息中定義的所有自定義屬性。這是通過方法實現(xiàn)的。下面的代碼示例演示了如何獲取和打印 MAPI 消息中定義的所有自定義屬性：

1. 使用方法獲取消息中定義的所有自定義屬性的集合。
2. 遍歷檢索到的集合中的每個自定義屬性。
3. 打印屬性詳細(xì)信息：標(biāo)簽、規(guī)范名稱和數(shù)據(jù)類型。

// Retrieve and print custom properties
var customProperties = msg.GetCustomProperties();
foreach (var customProperty in customProperties)
{
Console.WriteLine($"Tag: {customProperty.Tag}");
Console.WriteLine($"Canonical Name: {customProperty.Descriptor.CanonicalName}");
Console.WriteLine($"Data Type: {customProperty.Descriptor.DataType}");
}

結(jié)論

本文探討了使用Aspose.Email for .NET訪問、枚舉和操作 MAPI 屬性的各種技術(shù)。Aspose.Email 為處理這些屬性提供了全面的支持，允許開發(fā)人員通過精細(xì)控制來管理和操作電子郵件數(shù)據(jù)。通過使用此庫，開發(fā)人員可以創(chuàng)建復(fù)雜的電子郵件管理和處理解決方案，從而更輕松地使用標(biāo)準(zhǔn)、命名和自定義屬性。

歡迎下載|體驗更多Aspose文檔管理產(chǎn)品 

獲取更多信息請咨詢 或 加入Aspose技術(shù)交流群（666790229）