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

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

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

Aspose.Email 最新下載   

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

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

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

MAPI 屬性的類別

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

標準屬性

它們由 MAPI 規范定義，具有預定義的屬性標簽，通常用于消息傳遞對象的標準屬性。例如：

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

命名屬性

這些屬性由 GUID 和字符串名稱或整數標識符標識，可以實現比標準屬性更具體的分類和識別。

自定義（用戶定義）屬性

它們由開發人員定義，擴展了 MAPI 對象的功能，允許定制和特定于應用程序的數據處理。

列出所有 MAPI 屬性

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

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

// 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 屬性

常規 MAPI 屬性由包含屬性類型和屬性標識符的 16 位屬性標記標識，而命名屬性則由 GUID 和字符串名稱或整數標識符的組合標識：

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

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

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

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

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

通過描述符檢索屬性

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

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

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

通過標簽檢索屬性

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

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

// 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 消息中檢索常規屬性和命名屬性的過程。此方法允許您通過其描述符或標記直接訪問屬性，而無需手動檢查屬性集合。以下代碼示例演示了如何利用 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 屬性是附加屬性，不屬于預定義的 MAPI 屬性集。它們用于保存特定于應用程序的數據，由開發人員定義。通過允許開發人員定義和使用附加屬性，MAPI 提供了一種靈活而強大的方法來存儲和管理消息應用程序中的自定義數據。自定義屬性是命名屬性（使用 GUID 和字符串名稱）。Aspose.Email 引入了一種方法，您可以使用它來獲取消息中定義的所有自定義屬性。這是通過方法實現的。下面的代碼示例演示了如何獲取和打印 MAPI 消息中定義的所有自定義屬性：

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

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

結論

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

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

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