Documentation – OLM Dosyalarıyla Çalışma

Net: OLM Dosyalarını Açma

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for .NET, Mac için Outlook depolama dosyasını OlmStorage sınıf. Bu makale bir OLM dosyasını bir yol ya da akıştan açmayı ve bozuk olabilecek bir dosyayı güvenli bir şekilde yüklemeyi gösterir.

OLM Dosyası Aç

Bir OLM dosyası iki şekilde açılabilir:

yapıcı kullanarak;
statik FromFile metod.

Bu iki yaklaşım arasında klasör hiyerarşisinin nasıl başlatıldığına dair bir davranış farkı vardır. Bakınız OLM Klasörlerinde Gezinti detaylar için.

Yapıcıyı Kullanma

Bir dosya açmak için OlmStorage sınıfı ve tam dosya adını argüman olarak geçirin. Çünkü OlmStorage uygular IDisposable, bir using ifadesi, işiniz bittiğinde alt dosya tutamacının serbest bırakılmasını sağlar.

var fileName = "MyStorage.olm";
using (var olm = new OlmStorage(fileName))
{
    // work with the storage
}

Statik FromFile Yöntemini Kullanma

Bir dosya açmak için statik FromFile yöntemiyle tam dosya adını argüman olarak geçirebilirsiniz:

var fileName = "MyStorage.olm";
using (var olm = OlmStorage.FromFile(fileName))
{
    // work with the storage
}

Bir Akıştan OLM Dosyası Aç

OLM verileri yerel bir yoldan gelmediğinde - örneğin bir veritabanı, ağ kaynağı veya bulut depolama aracılığıyla alındığında - doğrudan bir Stream. Kullan OlmStorage(Stream) yapıcı ya da statik FromStream metod.

using (var stream = File.OpenRead("MyStorage.olm"))
using (var olm = new OlmStorage(stream))
{
    // work with the storage
}

Statik yöntem aynı şekilde çalışır:

using (var stream = File.OpenRead("MyStorage.olm"))
using (var olm = OlmStorage.FromStream(stream))
{
    // work with the storage
}

Kaynağı akışı, depolamaya eriştiğiniz sürece açık tutun. Akışı, klasörleri ve mesajları okumayı bitirmeden önce serbest bırakırsanız okuma hataları alırsınız.

Bozuk OLM Dosyası Aç

Bir dosya kısmen bozulmuşsa, ilk hatada durmadan mümkün olduğunca çok veri çıkarmaya devam edebilirsiniz. Bunu yapmak için OlmStorage instance with the OlmStorage(TraversalExceptionsCallback callback) yapıcıyı kullanın, ardından dosyayı Load yöntemi yerine FromFile.

Geri arama, yükleme ve dolaşma sırasında oluşan istisnaları alır, böylece bunları kaydedebilir ya da yok sayabilirsiniz. Load method returns true dosya başarıyla yüklendiyse ve dolaşım mümkünse, ve false dosya çok bozuk olduğunda dolaşmaya çalışamaz.

using (var olm = new OlmStorage((exception, id) =>
{
    // Exception handling code.
    Console.WriteLine($"Failed to process item '{id}': {exception.Message}");
}))
{
    if (olm.Load(fileName))
    {
        // The file was loaded and can be traversed.
        var folderHierarchy = olm.GetFolders();
    }
    else
    {
        Console.WriteLine("The OLM file is corrupted and cannot be traversed.");
    }
}

Bozuk bir dosyadan öğeler çıkarmak için eksiksiz bir örnek için bakınız OLM Mesajlarını Okuma ve Çıkarma.

Net: OLM Klasörlerinde Gezinti

Mon, 01 Jan 0001 00:00:00 +0000

Bir OLM dosyası verilerini bir klasör ağacına düzenler, her biri bir OlmFolder object. Bu makale, klasör hiyerarşisini nasıl enumerate edeceğinizi, isme göre belirli bir klasörü nasıl alacağınızı, alt klasörlerde nasıl gezineceğinizi ve klasör yollarını nasıl okuyacağınızı gösterir.

Klasör Hiyerarşisini Al

Dosya açıldıktan sonra, dizin yapısına şu aracılığıyla erişin FolderHierarchy özellik. Bu özellik bir liste döndürür: OlmFolder objeler, OLM dosyasındaki üst düzey dizini temsil eder. Daha derine gitmek için şunu okuyun SubFolders her klasörün alt dizinlerini döndüren property. Bu iki üye sayesinde tüm hiyerarşiyi dolaşabilirsiniz.

Aşağıdaki örnek tüm klasörleri hiyerarşik sırayla yazdırır:

using (var olm = new OlmStorage(fileName))
{
    PrintAllFolders(olm.FolderHierarchy, string.Empty);
}

private void PrintAllFolders(IEnumerable<OlmFolder> folderHierarchy, string indent)
{
    foreach (var folder in folderHierarchy)
    {
        Console.WriteLine($"{indent}{folder.Name}");
        PrintAllFolders(folder.SubFolders, indent + "-");
    }
}

FolderHierarchy ve FromFile Metodu

Dosyayı açma şekliniz, FolderHierarchy şöyle davranır:

Dosyayı yapıcı ile açtığınızda, FolderHierarchy property otomatik olarak başlatılır.
Dosyayı şu ile açtığınızda FromFile metodu, FolderHierarchy varsayılan olarak başlatılmaz ve null. Bu durumda, şu methodu çağırın GetFolders methodu tamamen hiyerarşiyi başlatmak ve dizin listesini almak için kullanın:

using (var olm = OlmStorage.FromFile(fileName))
{
    var folders = olm.GetFolders();
}

İsme Göre Klasör Al

İsme göre tek bir klasör almak için şu methodu çağırın GetFolder method. Klasör adını ilk argüman olarak, arama sırasında büyük/küçük harf duyarlılığının göz ardı edilip edilmeyeceğini belirten bir boolean’ı ikinci argüman olarak geçirin.

using (var olm = OlmStorage.FromFile(fileName))
{
    // get the Inbox folder by name, ignoring case
    OlmFolder folder = olm.GetFolder("Inbox", true);
}

İsme Göre Alt Klasör Al

Her OlmFolder aynı zamanda bir alt klasörü doğrudan GetSubFolder method. Alt klasör adını ve büyük/küçük harf duyarlılığının göz ardı edilip edilmeyeceğini geçirin. Bu, zaten bir üst klasörünüz olduğunda ve tüm hiyerarşiyi yeniden taramadan aşağı inmeyi istediğinizde faydalıdır.

using (var olm = OlmStorage.FromFile(fileName))
{
    OlmFolder inbox = olm.GetFolder("Inbox", true);

    // get a sub-folder of Inbox by name
    OlmFolder archive = inbox.GetSubFolder("Archive", true);

    if (archive != null)
    {
        Console.WriteLine($"Found sub-folder: {archive.Name}");
    }
}

Klasör Yollarını Al

Tam klasör yolunu şu aracılığıyla okuyabilirsiniz OlmFolder.Path property. Aşağıdaki snippet, dosyadaki her klasörün yolunu yazdırır:

using (var storage = new OlmStorage("SampleOLM.olm"))
{
    PrintPath(storage.FolderHierarchy);
}

public static void PrintPath(IEnumerable<OlmFolder> folders)
{
    foreach (OlmFolder folder in folders)
    {
        // print the current folder path
        Console.WriteLine(folder.Path);

        PrintPath(folder.SubFolders);
    }
}

Net: OLM Mesajlarını Okuma ve Çıkarma

Mon, 01 Jan 0001 00:00:00 +0000

Bir OLM dosyasını açıp bir klasör bulduktan sonra, mesajlarını listeleyebilir, kısa mesaj bilgilerini okuyabilir, büyük klasörlerde filtreleme ve sayfalama yapabilir ve bireysel mesajları şu şekilde çıkarabilirsiniz MapiMessage nesneler. Bu makale bu işlemlerin tümünü kapsar.

Bir Klasördeki Mesajları Listele

Bu OlmFolder sınıf, içinde barındırdığı mesajlar üzerinde iki şekilde yineleme imkanı sağlar:

EnumerateMessages bir OlmMessageInfo her yinelemede nesne. Bu nesne, mesaj hakkında kısa bilgi tutar ve bir klasörü taramanın en verimli yoludur.
EnumerateMapiMessages tam bir MapiMessage her yinelemede nesne, mesajın tüm özellikleri yüklü olarak.

EnumerateMessages Kullanımı

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);
    foreach (var messageInfo in folder.EnumerateMessages())
    {
        Console.WriteLine(messageInfo.Subject);
    }
}

EnumerateMapiMessages Kullanımı

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (var msg in folder.EnumerateMapiMessages())
    {
        // save the message in MSG format
        msg.Save($"{msg.Subject}.msg");
    }
}

Mesaj Bilgilerini Oku

Her OlmMessageInfo nesne, tam içeriğini yüklemeden bir mesajı tanımlayan yalnızca okunabilir bir dizi özelliği ortaya koyar. Bu, liste görünümü oluşturmanın veya hangi mesajların çıkarılacağına karar vermenin en verimli yoludur.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (OlmMessageInfo messageInfo in folder.EnumerateMessages())
    {
        Console.WriteLine($"Subject: {messageInfo.Subject}");
        Console.WriteLine($"From: {messageInfo.From}");
        Console.WriteLine($"To: {string.Join("; ", messageInfo.To)}");
        Console.WriteLine($"Date: {messageInfo.Date}");
        Console.WriteLine($"Modified: {messageInfo.ModifiedDate}");
        Console.WriteLine($"Has attachments: {messageInfo.HasAttachments}");
        Console.WriteLine($"Message class: {messageInfo.MessageClass}");
        Console.WriteLine(new string('-', 30));
    }
}

Bir Mesajın Değiştirilme Tarihini Al

The modified date represents the date and time when the OLM message was last modified. Use the OlmMessageInfo.ModifiedDate property to read it:

foreach (OlmMessageInfo messageInfo in inboxFolder.EnumerateMessages())
{
    DateTime modifiedDate = messageInfo.ModifiedDate;
}

Sorgu ile Mesajları Filtrele

For large folders, you can retrieve only the messages that match a set of criteria instead of iterating over everything. Pass a MailQuery için EnumerateMessages(MailQuery query) overload. Build the query with a MailQueryBuilder.

Aşağıdaki örnek, son yedi gün içinde gelen ve konu içinde "Invoice" kelimesi geçen mesajları sadece enumerate eder:

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    var builder = new MailQueryBuilder();
    builder.InternalDate.Since(DateTime.Now.AddDays(-7));
    builder.Subject.Contains("Invoice");
    MailQuery query = builder.GetQuery();

    foreach (var messageInfo in folder.EnumerateMessages(query))
    {
        Console.WriteLine(messageInfo.Subject);
    }
}

Mesajları Sayfalandır

When a folder contains a large number of messages, you can read them in batches with the EnumerateMessages(int skip, int count) overload. The skip parameter is the number of messages to bypass, and count is the number of messages to return.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    const int pageSize = 50;
    int pageIndex = 0;

    while (true)
    {
        var page = folder.EnumerateMessages(pageIndex * pageSize, pageSize).ToList();
        if (page.Count == 0)
        {
            break;
        }

        foreach (var messageInfo in page)
        {
            Console.WriteLine(messageInfo.Subject);
        }

        pageIndex++;
    }
}

Bir Mesajı MapiMessage Olarak Çıkar

Bu OlmStorage class, şunları sağlar ExtractMapiMessage method, which extracts a full MapiMessage from an OlmMessageInfo object. This is useful when you first scan a folder with EnumerateMessages and then extract only the messages you actually need.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (var messageInfo in folder.EnumerateMessages())
    {
        if (messageInfo.Date.Date == DateTime.Today)
        {
            // extract today's messages from Inbox
            var msg = olm.ExtractMapiMessage(messageInfo);
            msg.Save($"{msg.Subject}.msg");
        }
    }
}

Kimlik ile Mesajları Çıkar

Bazen mesajları kimlikleriyle seçerek çıkarmanız gerekir. Örneğin, bir uygulama kimlikleri bir veritabanında tutabilir ve her seferinde tüm depolamayı dolaşmak yerine ihtiyaç duyulduğunda bir mesaj çıkarabilir. The EntryId özelliği OlmMessageInfo provides the message entry identifier, and the overloaded ExtractMapiMessage(string id) method retrieves the message by that identifier.

using (var olm = OlmStorage.FromFile(fileName))
{
    var olmFolder = olm.GetFolder("Inbox", true);

    foreach (OlmMessageInfo msgInfo in olmFolder.EnumerateMessages())
    {
        // store msgInfo.EntryId somewhere, then later:
        MapiMessage msg = olm.ExtractMapiMessage(msgInfo.EntryId);
    }
}

Traversal API ile Öğeleri Çıkar

OLM dosyasından her öğeyi mümkün olduğu kadar istisna fırlatmadan çıkarabilirsiniz; orijinal dosyadaki bazı veriler bozulmuş olsa bile. Bunu yapmak için OlmStorage instance with the OlmStorage(TraversalExceptionsCallback callback) constructor and load the file with the Load method. Geri çağrı, yükleme ve dolaşım istisnalarını ortaya koyar.

Bu Load method returns true dosya başarıyla yüklendiyse ve dolaşım mümkünse, ve false dosya bozuksa ve dolaşım mümkün değilse. Öğeleri klasör klasöre dolaşırken, depolamanın EnumerateMessages(OlmFolder folder) method, klasörü argüman olarak geçerek.

Adımlar şunlardır:

Yeni bir OlmStorage instance, bir istisna işleme geri çağrısı geçerek.
Olm dosyasını şu yöntemi çağırarak yükleyin: Load metod.
Dosya başarılı bir şekilde yüklendiyse, klasör hiyerarşisini şu methodu çağırarak alın GetFolders.
Her klasörü yineleyerek iç içe dolaşın. Mesaj içeren klasörlerde, depolamanın EnumerateMessages method ve her birini işleyin.
Her alt klasöre girerek yineleyin.

using (var olm = new OlmStorage((exception, id) => { /* Exception handling code. */ }))
{
    if (olm.Load(fileName))
    {
        var folderHierarchy = olm.GetFolders();
        ExtractItems(olm, folderHierarchy);
    }
}

private static void ExtractItems(OlmStorage olm, IEnumerable<OlmFolder> folders)
{
    foreach (var folder in folders)
    {
        if (folder.HasMessages)
        {
            Console.WriteLine(folder);

            foreach (var msg in olm.EnumerateMessages(folder))
            {
                Console.WriteLine(msg.Subject);
            }
        }

        ExtractItems(olm, folder.SubFolders);
    }
}

Net: Öğeleri Sayma ve Kategorilerle Çalışma

Mon, 01 Jan 0001 00:00:00 +0000

Bireysel mesajları okumanın ötesinde, Aspose.Email for .NET bir OLM dosyasının veya klasörün kaç öğe içerdiğini incelemenize ve dosyada saklanan Outlook kategorilerini - renkleriyle birlikte - okumanıza olanak tanır. Bu makale her ikisini de kapsar.

Bir Klasörün Mesaj İçerip İçermediğini Kontrol Et

Bu OlmFolder.HasMessages özellik, bir klasörün mesaj içerip içermediğini gösterir ve OlmFolder.MessageCount özellik ne kadar olduğunu döndürür.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    if (folder.HasMessages)
    {
        Console.WriteLine($"Message count: {folder.MessageCount}");
    }
}

Her Klasördeki Öğeleri Say

Kullan OlmFolder.MessageCount her klasördeki öğe sayısını raporlayan özellik:

using (var storage = new OlmStorage("SampleOLM.olm"))
{
    PrintMessageCount(storage.FolderHierarchy);
}

public static void PrintMessageCount(IEnumerable<OlmFolder> folders)
{
    foreach (OlmFolder folder in folders)
    {
        Console.WriteLine($"Message Count [{folder.Name}]: {folder.MessageCount}");

        PrintMessageCount(folder.SubFolders);
    }
}

Depolamadaki Toplam Öğe Sayısını Al

Bu OlmStorage sınıf bir GetTotalItemsCount() tüm OLM depolamasında bulunan mesaj öğelerinin toplam sayısını döndüren yöntem:

using (var olm = new OlmStorage("storage.olm"))
{
    var count = olm.GetTotalItemsCount();
    Console.WriteLine($"Total items: {count}");
}

Outlook Kategori Renklerini Al

OLM dosyasında depolanan Outlook öğe kategorileriyle çalışmak için Aspose.Email şunları sunar:

the OlmItemCategory sınıf - bir Outlook öğe kategorisini, onun Ad ve ilişkili Renk, onaltılık biçimde temsil edilir;
the GetCategories() metodu OlmStorage sınıf - depolamada kullanılan kategori listesini alır.

Aşağıdaki örnek, depolamada kullanılan her kategoriyi rengiyle birlikte listeler:

using (var olm = OlmStorage.FromFile("storage.olm"))
{
    var categories = olm.GetCategories();

    foreach (var category in categories)
    {
        Console.WriteLine($"Category name: {category.Name}");

        // Color is represented as a hexadecimal value: #rrggbb
        Console.WriteLine($"Category color: {category.Color}");
    }
}

Bir Mesajın Kategori Rengini Al

Belirli bir mesaja atanmış kategorileri, depolama alanının kategori listesiyle karşılaştırarak her bir kategorinin rengini çözümleyebilirsiniz. Aşağıdaki örnek, bir klasördeki her mesajın kategorilerini okur ve her birinin rengini basar:

using (var olm = OlmStorage.FromFile("storage.olm"))
{
    var categories = olm.GetCategories();
    var folder = olm.GetFolder("Inbox", true);

    foreach (var msg in folder.EnumerateMapiMessages())
    {
        if (msg.Categories != null)
        {
            foreach (var msgCategory in msg.Categories)
            {
                Console.WriteLine($"Category name: {msgCategory}");

                var category = categories
                    .FirstOrDefault(c => c.Name.Equals(msgCategory, StringComparison.OrdinalIgnoreCase));

                Console.WriteLine(category != null
                    ? $"Category color: {category.Color}"
                    : "Category color: Not found");
            }
        }
    }
}

Net: OLM'den PST'ye Dönüştürme

Mon, 01 Jan 0001 00:00:00 +0000

OLM Microsoft Outlook for Mac tarafından kullanılan bir veritabanı dosyası formatıdır. OLM dosyaları e-posta mesajları, takvim verileri, kişiler ve uygulama ayarlarını saklar ve Windows Outlook tarafından desteklenmez. Outlook for Mac’ten Outlook for Windows’a bir posta kutusunu taşımak için OLM dosyasını Outlook PST format. Aspose.Email for .NET bunu kod içinde yapmanıza olanak tanır, Microsoft Outlook yüklü olmasa bile.

Dönüşüm Nasıl Çalışır

OLM dosyasını PST’ye dönüştürmek için şu adımları izleyin:

Şunun bir örneğini oluştur OlmStorage Kaynak OLM dosyasını açmak için sınıf.
Şununla yeni bir PST dosyası oluşturun: PersonalStorage.Create metod.
Implement a GetContainerClass method that maps a message class to the corresponding folder (container) class, so each folder is created with the correct type in the PST.
Implement an AddToPst her klasörü ve mesajlarını OLM dosyasından rekürsif olarak okuyan method - şu methodu kullanarak EnumerateMapiMessages - ve aynı sırayla PST’ye ekler, şu methodu kullanarak AddSubFolder ve AddMessage methods of FolderInfo.

Kod Örneği

Aşağıdaki kod bir OLM dosyasını PST’ye dönüştürmeyi gösterir.

Main metodu:

// create an instance of OlmStorage class to open the source OLM
using (var olm = new OlmStorage("my.olm"))
// create a new PST file
using (var pst = PersonalStorage.Create("my.pst", FileFormatVersion.Unicode))
{
    // recursively read each folder and its messages
    // and add them to the PST in the same order
    foreach (var olmFolder in olm.FolderHierarchy)
    {
        AddToPst(pst.RootFolder, olmFolder);
    }
}

GetContainerClass methodu:

public string GetContainerClass(string messageClass)
{
    if (messageClass.StartsWith("IPM.Contact") || messageClass.StartsWith("IPM.DistList"))
    {
        return "IPF.Contact";
    }

    if (messageClass.StartsWith("IPM.StickyNote"))
    {
        return "IPF.StickyNote";
    }

    if (messageClass.StartsWith("IPM.Activity"))
    {
        return "IPF.Journal";
    }

    if (messageClass.StartsWith("IPM.Task"))
    {
        return "IPF.Task";
    }

    if (messageClass.StartsWith("IPM.Appointment") || messageClass.StartsWith("IPM.Schedule.meeting"))
    {
        return "IPF.Appointment";
    }

    return "IPF.Note";
}

AddToPst methodu:

public void AddToPst(FolderInfo pstFolder, OlmFolder olmFolder)
{
    FolderInfo pstSubFolder = pstFolder.GetSubFolder(olmFolder.Name);

    foreach (var msg in olmFolder.EnumerateMapiMessages())
    {
        if (pstSubFolder == null)
        {
            pstSubFolder = pstFolder.AddSubFolder(olmFolder.Name, GetContainerClass(msg.MessageClass));
        }

        pstSubFolder.AddMessage(msg);
    }

    if (pstSubFolder == null)
    {
        pstSubFolder = pstFolder.AddSubFolder(olmFolder.Name);
    }

    foreach (var olmSubFolder in olmFolder.SubFolders)
    {
        AddToPst(pstSubFolder, olmSubFolder);
    }
}

tam tersine (PST’den OLM’ye) dönüşüm desteklenmez, çünkü OLM dosyası her zaman Outlook for Mac tarafından bir hesap eklenip sunucu ile senkronize edildiğinde oluşturulur.