MAPI Özelliklerini Yönet

E-posta verilerini programlı olarak yönetmek karmaşık olabilir, özellikle de Messaging Application Programming Interface (MAPI) özellikleri ile çalışırken. Bu özellikler, mesajlar, klasörler, alıcılar ve diğer iletişim sistemi bileşenleri gibi MAPI nesneleri ile ilişkili öznitelikler veya meta verilerdir. Bu özellikler, bir e-postanın konusu, gönderici adresi, e-postanın gönderildiği tarih gibi objeye dair detaylı bilgiler sağlar. MAPI özellikleri, e-posta verilerini yönetmek ve manipüle etmek için e-posta istemcileri ve diğer iletişim uygulamalarında yaygın olarak kullanılmaktadır. Bu makale, Aspose.Email for .NET kullanarak MAPI özelliklerine erişim, sıralama ve manipülasyon yapma tekniklerini incelemektedir.

C# ile MAPI Özelliklerini Yönetmek için .NET API

Aspose.Email for .NET, Messaging Application Programming Interface özelliklerini yönetmek için kapsamlı destek sunar; bu, geliştiricilerin e-posta verilerini detaylı bir şekilde yönetmesi ve manipüle etmesi için olanak tanır. Ayrıca, geliştiricilerin e-posta uygulamalarını mesaj işleme ve diğer ilgili görevler için güçlü özelliklerle donatmalarını sağlayan kapsamlı bir API’dir.

Aspose.Email for .NET kullanarak, geliştiriciler karmaşık e-posta yönetimi ve işleme çözümleri oluşturabilir. Kütüphaneyi kullanmaya başlamak için, Aspose web sitesinden veya NuGet üzerinden indirebilir ve projenize entegre edebilirsiniz.

MAPI Özelliklerinin Kategorileri

Projenizde Aspose.Email’in olduğundan emin olun ve başlayalım. MAPI özellikleri üç ana türe ayrılabilir: standart özellikler, adlandırılmış özellikler ve özel (kullanıcı tanımlı) özellikler. Her kategori farklı bir amaca hizmet eder ve e-posta verileri ile çalışan geliştiriciler için farklı seviyelerde esneklik ve kontrol sağlar. İşte her türün bir özeti:

Standart Özellikler

MAPI spesifikasyonu tarafından tanımlanmıştır, önceden tanımlanmış özellik etiketlerine sahiptir ve genellikle iletişim nesnelerinin standart öznitelikleri için kullanılır. Örneğin:

Adlandırılmış Özellikler

Bir GUID ve bir string adı veya bir tamsayı tanımlayıcı ile tanımlanan bu özellikler, standart özelliklerin ötesinde daha spesifik kategorilendirme ve tanımlama sağlar.

Özel (Kullanıcı Tanımlı) Özellikler

Geliştiriciler tarafından tanımlanmış olup, MAPI nesnelerinin işlevselliğini genişleterek özelleştirilmiş ve uygulama özgü veri yönetimi sağlar.

Tüm MAPI Özelliklerini Listeleme

Bir mesajdaki tüm MAPI özelliklerini listelemek için, mesajı yüklemek ve özelliklerini sıralamak için MapiMessage.Load yöntemini kullanacağız. Aşağıdaki kod örneği, bir MAPI mesajını yüklemeyi, özellikleri sıralamayı ve Aspose.Email for .NET kullanarak her bir özelliğin detaylı bilgilerini yazdırmayı göstermektedir:

  1. Belirtilen yoldan MAPI mesaj dosyasını yükleyin.
  2. msg.Properties.Values koleksiyonunu sıralayarak her bir özelliğe erişin.
  3. Her MAPI özelliği için etiketi, kanonik adı ve veri tipini yazdırın:
    • Tag özelliği, MAPI özelliği için benzersiz tanımlayıcıyı sağlar.
    • Descriptor.CanonicalName özelliği, özelliğin okunabilir adını verir.
    • Descriptor.DataType özelliği, özelliğin veri tipini belirtir.
// 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}");
}
view raw ListAllProperties.cs hosted with ❤ by GitHub

Adlandırılmış MAPI Özelliklerini Listeleme

Normal MAPI özellikleri, özellik türü ve özellik tanımlayıcısından oluşan 16 bitlik bir özellik etiketi ile tanımlanırken, adlandırılmış özellikler bir GUID ve bir string adı veya bir tamsayı tanımlayıcısının bir kombinasyonu ile tanımlanır:

  • GUID (Küresel Benzersiz Tanımlayıcı): Özellik kümesinin benzersiz olduğunu garanti eden benzersiz bir tanımlayıcıdır. Bu GUID genellikle geliştirici tarafından sağlanır.
  • İsim veya ID:
    • Bir string adı (büyük/küçük harf duyarlı).
    • 32 bitlik bir tamsayı tanımlayıcı.

Aşağıdaki kod örneği, bir mesajın adlandırılmış MAPI özelliklerini sıralamak için Aspose.Email for .NET kullanmayı ve özellik tanımlayıcı türüne göre detaylı bilgileri yazdırmayı göstermektedir:

  1. Yüklenen MapiMessage nesnesinin ‘NamedProperties.Values’ koleksiyonuna erişerek her bir adlandırılmış özelliği sıralayın.
  2. Mevcut adlandırılmış özelliğin Tanımlayıcısının PidNamePropertyDescriptor türünde olup olmadığını kontrol edin. Eğer öyleyse, Tanımlayıcıyı PidNamePropertyDescriptor olarak dönüştürün. Özelliğin GUID’ini, Kanonik Adını ve Veri Tipini yazdırın.
  3. Mevcut adlandırılmış özelliğin Tanımlayıcısının PidLidPropertyDescriptor türünde olup olmadığını kontrol edin. Eğer öyleyse, Tanımlayıcıyı PidLidPropertyDescriptor olarak dönüştürün. Özelliğin GUID’ini, Kanonik Adını, Uzun ID’sini ve Veri Tipini yazdırın.
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}");
}
}
view raw ListNamedProperties.cs hosted with ❤ by GitHub

Böylece, belirli özellikleri PropertySet, CanonicalName, DataType ve LongId şeklinde tanımlayıcı türüne (PidNamePropertyDescriptor veya PidLidPropertyDescriptor) göre yazdırmış olduk.

Tanımlayıcı ile Özellikleri Alma

Tanımlayıcı ile özellikleri almak, tüm özellik koleksiyonu üzerinden geçmeden belirli MAPI özelliklerine erişmek için basit bir yol sunar. Aspose.Email for .NET, KnownPropertyList kullanarak özellikleri almak için uygun bir yol sağlar. Aşağıdaki kod örneği, InternetMessageId gibi belirli bir özelliği almayı ve detaylarını yazdırmayı göstermektedir.

  1. MapiMessage nesnesinin Properties koleksiyonundan InternetMessageId özelliğine erişin.
  2. Özelliğin null olmadığını doğrulayarak mesajda mevcut olduğundan emin olun.
  3. Alınan özelliğin detaylarını yazdırın: Etiket, Kanonik Ad ve Veri Tipi.
  4. Özellik veri tipi bir string ise, GetString yöntemini kullanarak özellik değerini alın ve yazdırın.
// 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}");
}
}
view raw GetPropertiesByDescriptor.cs hosted with ❤ by GitHub

Etiket ile Özellikleri Alma

Bir özellik etiketi, benzersiz bir MAPI özelliğini tanımlayan 32 bitlik bir tanımlayıcıdır. Bir özellik ID’si ve bir özellik türünden oluşur. Özellik etiketlerini kullanarak, bir MAPI mesajı içindeki belirli özelliklere doğrudan erişebilirsiniz. Aşağıdaki kod örneği, PR_HASATTACH gibi belirli bir özelliği almayı ve detaylarını yazdırmayı göstermektedir.

  1. MapiPropertyTag kullanarak MapiMessage nesnesinin Properties koleksiyonundan doğrudan PR_HASATTACH özelliğine erişin.
  2. Özelliğin null olmadığını doğrulayarak mesajda mevcut olduğundan emin olun.
  3. Alınan özelliğin detaylarını yazdırın: Etiket ve Veri Tipi.
  4. Özellik veri tipi boolean ise, GetBoolean yöntemini kullanarak özellik değerini alın ve mesajın ekleri olup olmadığını yazdırın.
// 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}");
}
}
view raw GetPropertiesByTag.cs hosted with ❤ by GitHub

GetProperty Yöntemini Kullanma

GetProperty yöntemi, bir MAPI mesajından hem normal hem de adlandırılmış özellikleri almayı basitleştirir. Bu yöntem, özellikler koleksiyonunu manuel olarak kontrol etmeden, bir tanımlayıcı veya etiket aracılığıyla doğrudan bir özelliğe erişmenizi sağlar. Aşağıdaki kod örneği, belirli MAPI özelliklerine erişmek için GetProperty yöntemini nasıl kullanacağınızı göstermektedir:

  1. GetProperty yöntemini kullanarak KnownPropertyList sınıfından CurrentVersionName özelliğine doğrudan erişin.
  2. Özelliğin null olmadığını doğrulayarak mesajda mevcut olduğundan emin olun.
  3. GetString yöntemini kullanarak özellik değerini alın ve yazdırın.
// Retrieve and print the CurrentVersionName property
var namedProperty = msg.GetProperty(KnownPropertyList.CurrentVersionName);
if (namedProperty != null)
{
Console.WriteLine($"Current Version Name: {namedProperty.GetString()}");
}
view raw GetProperty.cs hosted with ❤ by GitHub

Burada, GetProperty kullanılarak CurrentVersionName özelliğine doğrudan erişilmiştir.

Özel Özelliklerle Çalışma

Özel MAPI özellikleri, önceden tanımlanmış MAPI özellikleri kümesine dahil olmayan ek özelliklerdir. Uygulama spesifik verileri tutmak için oluşturulur ve geliştirici tarafından tanımlanır. Geliştiricilerin ek özellikler tanımlayıp kullanmalarına olanak tanıyarak, MAPI, iletişim uygulamaları içinde özel verileri depolamak ve yönetmek için esnek ve güçlü bir yol sunar. Özel özellikler, adlandırılmış özelliklerdir (bir GUID ve string adı kullanılır). Aspose.Email, mesajda tanımlı tüm özel özellikleri almanızı sağlayan bir yaklaşım sunar. Bu, GetCustomProperties yöntemi ile gerçekleştirilir. Aşağıdaki kod örneği, bir MAPI mesajında tanımlı tüm özel özellikleri almayı ve yazdırmayı göstermektedir:

  1. GetCustomProperties yöntemini kullanarak mesajda tanımlı tüm özel özelliklerin bir koleksiyonunu elde edin.
  2. Alınan koleksiyondaki her bir özel özelliği sıralayın.
  3. Özellik detaylarını yazdırın: Etiket, Kanonik Ad ve Veri Tipi.
// 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}");
}
view raw GetCustomProperties.cs hosted with ❤ by GitHub

Sonuç

Bu makale, Aspose.Email for .NET kullanarak MAPI özelliklerine erişim, sıralama ve manipülasyon yapma tekniklerini keşfetmiştir. Aspose.Email, bu özellikleri yönetmek için kapsamlı destek sunarak geliştiricilerin e-posta verilerini detaylı bir şekilde yönetmelerine ve manipüle etmelerine olanak tanır. Bu kütüphane kullanılarak, geliştiriciler karmaşık e-posta yönetimi ve işleme çözümleri oluşturabilir, böylece standart, adlandırılmış ve özel özelliklerle çalışmayı kolaylaştırabilirler.

Ayrıca, Aspose.Email, geliştirme sürecinizi artırmak için kapsamlı belgelere, geniş bir API referansına ve çeşitli ücretsiz çevrimiçi araçlar ve uygulamalara sahiptir. Geliştiriciler ayrıca topluluk yardımı ve içgörüleri için ücretsiz bir destek forumuna erişebilir ve Aspose blogu aracılığıyla en son ipuçları ve eğitimlerle güncel kalabilirler. Bu kaynaklar, projelerinizde kütüphanenin potansiyelini artırmak için çok değerlidir.

Ayrıca Bakınız