Documentation – Робота з файлами сховища Outlook

Net: Створення і керування файлами PST

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

Окрім аналізу існуючого PST‑файлу, Aspose.Email надає засоби для створення PST‑файлу з нуля. У цій статті демонструється, як створювати Outlook PST‑файли та додавати до них підпапки або повідомлення.

Створення PST‑файлів

Щоб створити новий PST‑файл на локальному диску, вам потрібно використати PersonalStorage class. За допомоги цього класу ви можете створювати, читати та маніпулювати PST‑файлами у ваших .NET‑застосунках. Створіть файл сховища з нуля за допомогою одного рядка коду:

// Create new PST
using var pst = PersonalStorage.Create(path, FileFormatVersion.Unicode);

Додавання підпапок до PST

Додайте підпапку у корені файлу PST, отримавши доступ до кореневої папки, а потім викликавши AddSubFolder метод.

Наступний фрагмент коду показує, як додати підпапку під назвою Inbox:

// Add new folder "Test"
pst.RootFolder.AddSubFolder("Inbox");

Перевірка класу контейнера папки

При створенні нових папок або додаванні елементів до існуючих папок важливо переконатися, що клас контейнера нового елемента або папки відповідає класу контейнера батьківської папки, щоб зберегти ієрархічну структуру в PST‑файлі. Для цього Aspose.Email має. EnforceContainerClassMatching властивість FolderCreationOptions class. Властивість визначає, чи слід примусово перевіряти клас контейнера додаємої папки щодо класу контейнера батьківської папки. Якщо встановити ’true’, буде викинуто виняток, якщо класи контейнерів не збігаються. За замовчуванням — ‘false’.

Наведений зразок коду демонструє використання EnforceContainerClassMatching властивість для контролю, чи має бути виняток при додаванні тек з несумісними класами контейнерів:

using (var pst = PersonalStorage.Create("storage.pst", FileFormatVersion.Unicode))
{
    // Create a standard Contacts folder with the IPF.Contacts container class.
    var contacts = pst.CreatePredefinedFolder("Contacts", StandardIpmFolder.Contacts);
    
    // An exception will not arise. EnforceContainerClassMatching is false by default.
    contacts.AddSubFolder("Subfolder1", "IPF.Note");
    
    // An exception will occur as the container class of the subfolder being added (IPF.Note) 
    // does not match the container class of the parent folder (IPF.Contact).
    contacts.AddSubFolder("Subfolder3", new FolderCreationOptions {EnforceContainerClassMatching = true, ContainerClass = "IPF.Note"});
}

Примітка: Забезпечте правильну обробку винятків при примусовому відповідності класу контейнера, щоб запобігти непередбачуваній поведінці під час створення тек у PST.

Змінити клас контейнера теки

Іноді необхідно змінити клас контейнера теки. Поширений приклад — коли повідомлення різних типів (зустрічі, листи тощо) додаються до однієї теки. У таких випадках клас теки потрібно змінити для всіх елементів, щоб вони відображалися правильно. Наведений фрагмент коду показує, як змінити клас контейнера теки у PST з цією метою.

using var pst = PersonalStorage.FromFile("PersonalStorage1.pst);
var folder = pst.RootFolder.GetSubFolder("Inbox");

folder.ChangeContainerClass("IPF.Note");

Додавання файлів до PST

Ключова функціональність Microsoft Outlook — це управління електронними листами, календарями, завданнями, контактами та журналами. Крім того, файли також можна додавати до теки PST, і отриманий PST зберігає запис доданих документів. Aspose.Email надає можливість додавати файли до теки так само, як і повідомлення, контакти, завдання та журнали до PST. Наведений фрагмент коду показує, як додати документи до теки PST за допомогою Aspose.Email.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (var personalStorage = PersonalStorage.Create(dataDir + "Ps1_out.pst", FileFormatVersion.Unicode))
{
    var folder = personalStorage.RootFolder.AddSubFolder("Files");

    // Add Document.doc file with the "IPM.Document" message class by default.
    folder.AddFile(dataDir + "attachment_1.doc", null);
}

Додавання повідомлень до файлів PST

За допомогою Aspose.Email ви можете додавати повідомлення до підтеки файлу PST, який ви створили або завантажили. У цій статті додаються два повідомлення з диска до підтеки Inbox у PST. Використайте PersonalStorage і FolderInfo класи для додавання повідомлень до файлів PST. Щоб додати повідомлення до папки Inbox у файлі PST:

Створіть екземпляр класу FolderInfo і завантажте його вмістом теки Inbox.
Додайте повідомлення з диска до теки Inbox, викликавши FolderInfo.AddMessage() метод. FolderInfo клас надає AddMessages метод, який дозволяє додавати велику кількість повідомлень у теку, зменшуючи операції вводу/виводу на диск і підвищуючи продуктивність.

Фрагмент коду нижче показує, як додати повідомлення до підтеки PST під назвою Inbox.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create new PST            
var personalStorage = PersonalStorage.Create(dataDir, FileFormatVersion.Unicode);

// Add new folder "Inbox"
personalStorage.RootFolder.AddSubFolder("Inbox");

// Select the "Inbox" folder
var inboxFolder = personalStorage.RootFolder.GetSubFolder("Inbox");

// Add some messages to "Inbox" folder
inboxFolder.AddMessage(MapiMessage.FromFile(RunExamples.GetDataDir_Outlook() + "MapiMsgWithPoll.msg"));

Додати повідомлення пакетно з підвищеною продуктивністю

Додавання окремих повідомлень до PST передбачає більше операцій вводу/виводу на диск і може сповільнити продуктивність. Щоб підвищити продуктивність, повідомлення можна додавати до PST пакетно, мінімізуючи операції вводу/виводу. The AddMessages метод дозволяє додавати повідомлення пакетно і може бути використаний у наступних сценаріях. Крім того, MessageAdded подія виникає, коли повідомлення додається до папки.

Додати повідомлення з іншого PST

Щоб додати повідомлення з іншого PST, використовуйте FolderInfo.EnumerateMapiMessages метод, який повертає IEnumerable<MapiMessage>:

using var srcPst = PersonalStorage.FromFile(@"source.pst", false);
using var destPst = PersonalStorage.FromFile(@"destination.pst");

// Get the folder by name
var srcFolder = srcPst.RootFolder.GetSubFolder("SomeFolder");
var destFolder = destPst.RootFolder.GetSubFolder("SomeFolder");

destFolder.MessageAdded += new MessageAddedEventHandler(OnMessageAdded);
destFolder.AddMessages(srcFolder.EnumerateMapiMessages());


// Handles the MessageAdded event.
static void OnMessageAdded(object sender, MessageAddedEventArgs e)
{
    Console.WriteLine($"Added: {e.EntryId}");
}

Додати повідомлення з каталогу

Щоб додати повідомлення з каталогу, створіть GetMessages(string pathToDir) іменований метод-ітератор, який повертає IEnumerable<MapiMessage>:

using var pst = PersonalStorage.FromFile(@"storage.pst");
var folder = pst.RootFolder.GetSubFolder("SomeFolder");
folder.MessageAdded += OnMessageAdded;
folder.AddMessages(GetMessages(@"MessageDirectory"));

// Named iterator method to read messages from directory.
static IEnumerable<MapiMessage> GetMessages(string pathToDir)
{
    string[] files = Directory.GetFiles(pathToDir, "*.msg");

    foreach (var file in files)
    {
        yield return MapiMessage.Load(file);
    }
}

// Handles the MessageAdded event.
static void OnMessageAdded(object sender, MessageAddedEventArgs e)
{
    Console.WriteLine($"Added: {e.EntryId}");
}

Завантаження повідомлень з диска

Наведений фрагмент коду показує, як завантажити повідомлення з диска.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
private static void AddMessagesInBulkMode(string fileName, string msgFolderName)
{
    using (PersonalStorage personalStorage = PersonalStorage.FromFile(fileName))
    {
        FolderInfo folder = personalStorage.RootFolder.GetSubFolder("myInbox");
        folder.MessageAdded += OnMessageAdded;
        folder.AddMessages(new MapiMessageCollection(msgFolderName));
    }
}
static void OnMessageAdded(object sender, MessageAddedEventArgs e)
{
    Console.WriteLine(e.EntryId);
    Console.WriteLine(e.Message.Subject);
}

Реалізація IEnumerable

Наведений фрагмент коду показує, як можна використати реалізацію IEnumerable.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public class MapiMessageCollection : IEnumerable<MapiMessage>
{
    private string path;

    public MapiMessageCollection(string path)
    {
        this.path = path;
    }

    public IEnumerator<MapiMessage> GetEnumerator()
    {
        return new MapiMessageEnumerator(path);
    }

    IEnumerator IEnumerable.GetEnumerator()
    {
        return GetEnumerator();
    }
}

public class MapiMessageEnumerator : IEnumerator<MapiMessage>
{
    private readonly string[] files;

    private int position = -1;

    public MapiMessageEnumerator(string path)
    {
        string path1 = RunExamples.GetDataDir_Outlook();
        files = Directory.GetFiles(path1);
    }

    public bool MoveNext()
    {
        position++;
        return (position < files.Length);
    }

    public void Reset()
    {
        position = -1;
    }

    object IEnumerator.Current
    {
        get
        {
            return Current;
        }
    }

    public MapiMessage Current
    {
        get
        {
            try
            {
                return MapiMessage.FromFile(files[position]);
            }
            catch (IndexOutOfRangeException)
            {
                throw new InvalidOperationException();
            }
        }
    }
    public void Dispose()
    {
    }
}

Net: Асинхронні операції з PST‑файлами

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

Для підвищення масштабованості та адаптивності сучасних застосунків Aspose.Email для .NET надає асинхронні методи роботи з PST‑файлами. Ці нові API дозволяють розробникам створювати, відкривати, зливати та розділяти PST‑файли без блокування головного потоку, що робить їх ідеальними для UI‑застосунків та високонавантажених сервісів.

Асинхронне створення PST‑файлів

The PersonalStorage.CreateAsync метод дозволяє асинхронно створити новий PST‑файл, забезпечуючи неблокуюче виконання у застосунках, які працюють з великими даними або потребують адаптивних інтерфейсів. Наступний приклад коду демонструє, як впровадити цю функцію у C#‑проєкт:

string pstFilePath = "newMailbox.pst";
var format = FileFormatVersion.Unicode;

// Create a new PST file asynchronously
using (var pst = await PersonalStorage.CreateAsync(pstFilePath, format, CancellationToken.None))
{
     Console.WriteLine($"PST file created at: {pstFilePath}");
}

Асинхронне відкриття PST‑файлів

Щоб асинхронно відкрити існуючий PST‑файл, використовуйте PersonalStorage.FromFileAsync метод API Aspose.Email. Наступний приклад коду демонструє, як впровадити цю функцію у C#‑проєкт:

string pstFilePath = "newMailbox.pst";
var format = FileFormatVersion.Unicode;

// Open the PST file asynchronously
        using (var pst = await PersonalStorage.FromFileAsync(pstFilePath, CancellationToken.None))
        {
            Console.WriteLine("PST file opened successfully.");

            // Access folders or messages here
            Console.WriteLine($"Root folder name: {pst.RootFolder.DisplayName}");
}

Асинхронне злиття PST‑файлів

The MergeWithAsync метод Aspose.Email PersonalStorage клас дозволяє асинхронно об’єднати вміст одного PST‑файлу з іншим. Це корисно у сценаріях, таких як консолідація архівів пошти, об’єднання резервних копій або пакетна обробка даних електронної пошти — без блокування головного потоку вашого застосунку. Наведений нижче приклад коду демонструє, як використовувати цей метод у вашому C#‑проєкті:

string targetPstPath = "mainMailbox.pst";
string sourcePstPath = "archiveToMerge.pst";

// Open both PST files asynchronously
using (var targetPst = await PersonalStorage.FromFileAsync(targetPstPath, CancellationToken.None))
using (var sourcePst = await PersonalStorage.FromFileAsync(sourcePstPath, CancellationToken.None))
{
    // Merge the source PST into the target PST
    await targetPst.MergeWithAsync(sourcePst, CancellationToken.None);

    Console.WriteLine("Merge operation completed successfully.");
}

Асинхронне розділення PST‑файлів

Наведений нижче приклад коду демонструє, як асинхронно відкрити існуючий PST‑файл за допомогою FromFileAsync, а потім розділити його на кілька частин за допомогою SplitIntoAsync. Кожна частина не буде перевищувати 50 МБ і буде збережена у вказаному вихідному каталозі. Асинхронне виконання забезпечує, що операція не блокує головний потік, що робить її придатною для застосунків, що обробляють великі архіви PST.

using (var pst = await PersonalStorage.FromFileAsync("input.pst"))
{
    await pst.SplitIntoAsync(50 * 1024 * 1024, "part_", "outputDirectory", CancellationToken.None);
}

Net: Керування повідомленнями у файлах PST

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

Отримання інформації про повідомлення з Outlook PST‑файла

У Читання файлів PST та отримання інформації У статті ми розглядали, як завантажити файл Outlook PST і переглянути його папки, щоб отримати назви папок та кількість повідомлень у них. У цій статті пояснюється, як читати всі папки та підпапки у файлі PST і відображати інформацію про повідомлення, наприклад тему, відправника та одержувачів. Файл Outlook PST може містити вкладені папки. Щоб отримати інформацію про повідомлення з цих папок, а також з папок верхнього рівня, використовуйте рекурсивний метод для читання всіх папок. Наведений нижче фрагмент коду показує, як читати файл Outlook PST і рекурсивно відображати вміст папок і повідомлень.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{            
    string dataDir = RunExamples.GetDataDir_Outlook();

    // Load the Outlook file
    string path = dataDir + "PersonalStorage.pst";

    try
    {
       
        // Load the Outlook PST file
        PersonalStorage personalStorage = PersonalStorage.FromFile(path);

        // Get the Display Format of the PST file
        Console.WriteLine("Display Format: " + personalStorage.Format);

        // Get the folders and messages information
        FolderInfo folderInfo = personalStorage.RootFolder;

        // Call the recursive method to display the folder contents
        DisplayFolderContents(folderInfo, personalStorage);
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);               
    }            
}

/// <summary>
/// This is a recursive method to display contents of a folder
/// </summary>
/// <param name="folderInfo"></param>
/// <param name="pst"></param>
private static void DisplayFolderContents(FolderInfo folderInfo, PersonalStorage pst)
{
    // Display the folder name
    Console.WriteLine("Folder: " + folderInfo.DisplayName);
    Console.WriteLine("==================================");
    // Display information about messages inside this folder
    MessageInfoCollection messageInfoCollection = folderInfo.GetContents();
    foreach (MessageInfo messageInfo in messageInfoCollection)
    {
        Console.WriteLine("Subject: " + messageInfo.Subject);
        Console.WriteLine("Sender: " + messageInfo.SenderRepresentativeName);
        Console.WriteLine("Recipients: " + messageInfo.DisplayTo);
        Console.WriteLine("------------------------------");
    }

    // Call this method recursively for each subfolder
    if (folderInfo.HasSubFolders == true)
    {
        foreach (FolderInfo subfolderInfo in folderInfo.GetSubFolders())
        {
            DisplayFolderContents(subfolderInfo, pst);
        }
    }
}

Витягування повідомлень з PST‑файлів

У цій статті показано, як читати файли Microsoft Outlook PST та витягати повідомлення. Потім повідомлення зберігаються на диск у форматі MSG.

Спробуйте!

Запустіть ConversationThread простий проєкт застосунку, у якому досліджується цікаве використання функціоналу Aspose.Email для читання електронних листів із PST та знаходження діалогових ланцюжків.

Нижче наведений фрагмент коду показує, як витягти повідомлення з PST‑файлу:

Використайте рекурсивний метод для обходу всіх папок (включаючи вкладені) і викличте метод PersonalStorage.ExtractMessage(), щоб отримати повідомлення Outlook у екземпляр MapiMessage клас.
Після цього викличте метод MapiMessage.Save(), щоб зберегти повідомлення на диск або у потік у форматі MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{            
    // The path to the file directory.
    string dataDir = RunExamples.GetDataDir_Outlook();

    // Load the Outlook file
    string path = dataDir + "PersonalStorage.pst";

    try
    {
        // load the Outlook PST file
        PersonalStorage pst = PersonalStorage.FromFile(path);

        // get the Display Format of the PST file
        Console.WriteLine("Display Format: " + pst.Format);

        // get the folders and messages information
        FolderInfo folderInfo = pst.RootFolder;

        // Call the recursive method to extract msg files from each folder
        ExtractMsgFiles(folderInfo, pst);
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }            
}

/// <summary>
/// This is a recursive method to display contents of a folder
/// </summary>
/// <param name="folderInfo"></param>
/// <param name="pst"></param>
private static void ExtractMsgFiles(FolderInfo folderInfo, PersonalStorage pst)
{
    // display the folder name
    Console.WriteLine("Folder: " + folderInfo.DisplayName);
    Console.WriteLine("==================================");
    // loop through all the messages in this folder
    MessageInfoCollection messageInfoCollection = folderInfo.GetContents();
    foreach (MessageInfo messageInfo in messageInfoCollection)
    {
        Console.WriteLine("Saving message {0} ....", messageInfo.Subject);
        // get the message in MapiMessage instance
        MapiMessage message = pst.ExtractMessage(messageInfo);
        // save this message to disk in msg format
        message.Save(message.Subject.Replace(":", " ") + ".msg");
        // save this message to stream in msg format
        MemoryStream messageStream = new MemoryStream();
        message.Save(messageStream);
    }

    // Call this method recursively for each subfolder
    if (folderInfo.HasSubFolders == true)
    {
        foreach (FolderInfo subfolderInfo in folderInfo.GetSubFolders())
        {
            ExtractMsgFiles(subfolderInfo, pst);
        }
    }
}

Ідентифікація типів елементів MAPI

The MapiItemType перерахування представляє тип елементу MAPI, який може бути явно конвертований у об’єкт відповідного класу, що успадкований від IMapiMessageItem інтерфейс. Таким чином користувачі можуть уникнути перевірки MessageClass значення властивості перед конвертацією повідомлення.

Нижче наведений приклад коду показує, як визначити тип елемента для конвертації:

foreach (var messageInfo in folder.EnumerateMessages())
{
    var msg = pst.ExtractMessage(messageInfo);

    switch (msg.SupportedType)
    {
        // Non-supported type. MapiMessage cannot be converted to an appropriate item type.
        // Just use in MSG format.
        case MapiItemType.None:
            break;
        // An email message. Conversion isn't required.
        case MapiItemType.Message:
            break;
        // A contact item. Can be converted to MapiContact.
        case MapiItemType.Contact:
            var contact = (MapiContact)msg.ToMapiMessageItem();
            break;
        // A calendar item. Can be converted to MapiCalendar.
        case MapiItemType.Calendar:
            var calendar = (MapiCalendar)msg.ToMapiMessageItem();
            break;
        // A distribution list. Can be converted to MapiDistributionList.
        case MapiItemType.DistList:
            var dl = (MapiDistributionList)msg.ToMapiMessageItem();
            break;
        // A Journal entry. Can be converted to MapiJournal.
        case MapiItemType.Journal:
            var journal = (MapiJournal)msg.ToMapiMessageItem();
            break;
        // A StickyNote. Can be converted to MapiNote.
        case MapiItemType.Note:
            var note = (MapiNote)msg.ToMapiMessageItem();
            break;
        // A Task item. Can be converted to MapiTask.
        case MapiItemType.Task:
            var task = (MapiTask)msg.ToMapiMessageItem();
            break;
    }
}

Пошук та отримання повідомлень

Aspose.Email надає наступні перевантажені методи FolderInfo клас для фільтрації та отримання повідомлень:

IEnumerable EnumerateMessages(MailQuery mailQuery) - Фільтрувати повідомлення за допомогою MailQuery.
IEnumerable EnumerateMessages(MessageKind kind) - Отримати повідомлення за типом (MessageKind).
IEnumerable EnumerateMessages(int startIndex, int count) - Пагінація отримання повідомлень за допомогою початкового індексу та кількості.

Пагіноване отримання вмісту папки

При роботі з великими PST‑папками отримання всіх повідомлень одночасно може бути неефективним. Для підвищення продуктивності та контролю Aspose.Email для .NET пропонує підтримку пагінації у FolderInfo.GetContents метод. Цей метод отримує підмножину повідомлень, які відповідають зазначеному запиту, починаючи з певного індексу і обмежені кількістю. Це дозволяє отримувати повідомлення невеликими, керованими порціями. Метод приймає такі параметри:

IList<MessageInfo> FolderInfo.GetContents(MailQuery query, int startIndex, int count)

query — фільтр, який застосовується до повідомлень (необов’язково)
startIndex — індекс, починаючи з нуля, з якого слід отримувати
count — кількість повідомлень, які треба повернути

Нижче наведений приклад коду демонструє, як впровадити цей метод у проєкт:

// Load the PST file
using (var pst = PersonalStorage.FromFile(fileName))
{
    // Access a specific subfolder
    var folder = pst.RootFolder.GetSubFolder("Inbox");

    // Build a query to filter messages by sender address
    var queryBuilder = new PersonalStorageQueryBuilder();
    queryBuilder.From.Contains("report-service", true);

    // Define the page size
    int pageSize = 5;

    // Retrieve and process messages in pages
    for (int pageIndex = 0; pageIndex < 6; pageIndex++)
    {
        int startIndex = pageIndex * pageSize;

        // Get a page of messages
        var messages = folder.GetContents(queryBuilder.GetQuery(), startIndex, pageSize);

        foreach (MessageInfo messageInfo in messages)
        {
            // Output basic info about each message
            Console.WriteLine($"Subject: {messageInfo.Subject}, Sender: {messageInfo.SenderRepresentativeName}");
        }
    }
}

Зберегти повідомлення безпосередньо з PST у потік

Щоб зберегти повідомлення з PST‑файлу безпосередньо у потік, без витягнення MsgInfo для повідомлень, використайте метод SaveMessageToStream(). Нижче наведений фрагмент коду показує, як зберегти повідомлення безпосередньо з PST у потік.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the file directory.
string dataDir = RunExamples.GetDataDir_Outlook();

// Load the Outlook file
string path = dataDir + "PersonalStorage.pst";

// Save message to MemoryStream
using (PersonalStorage personalStorage = PersonalStorage.FromFile(path))
{
    FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");
    foreach (MessageInfo messageInfo in inbox.EnumerateMessages())
    {
        using (MemoryStream memeorystream = new MemoryStream())
        {
            personalStorage.SaveMessageToStream(messageInfo.EntryIdString, memeorystream);
        }
    }
}

// Save message to file
using (PersonalStorage pst = PersonalStorage.FromFile(path))
{
    FolderInfo inbox = pst.RootFolder.GetSubFolder("Inbox");
    foreach (MessageInfo messageInfo in inbox.EnumerateMessages())
    {
        using (FileStream fs = File.OpenWrite(messageInfo.Subject + ".msg"))
        {
            pst.SaveMessageToStream(messageInfo.EntryIdString, fs);
        }
    }
}

using (PersonalStorage pst = PersonalStorage.FromFile(path))
{
    FolderInfo inbox = pst.RootFolder.GetSubFolder("Inbox");
    
    // To enumerate entryId of messages you may use FolderInfo.EnumerateMessagesEntryId() method:
    foreach (string entryId in inbox.EnumerateMessagesEntryId())
    {
        using (MemoryStream ms = new MemoryStream())
        {
            pst.SaveMessageToStream(entryId, ms);
        }
    }
}

Витягнути певну кількість повідомлень

Наступний фрагмент коду показує, як витягнути певну кількість повідомлень з PST. Просто вкажіть індекс першого повідомлення та загальну кількість повідомлень для витягнення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");

// Extracts messages starting from 10th index top and extract total 100 messages
MessageInfoCollection messages = inbox.GetContents(10, 100);

Отримати загальну кількість елементів з PST

Aspose.Email надає GetTotalItemsCount() метод PersonalStorage.Store властивість. Вона повертає загальну кількість повідомлень, що містяться у PST.

Наступний зразок коду показує, як отримати загальну кількість елементів (повідомлень, зустрічей, контактів тощо), що зберігаються у PST‑файлі:

using (var pst = PersonalStorage.FromFile("my.pst", false))
{
    var count = pst.Store.GetTotalItemsCount();
}

Витягнути вкладення без повного витягнення повідомлення

API Aspose.Email можна використати для витягування вкладень з PST повідомлень без попереднього повного витягування повідомлення. Цей ExtractAttachments метод PersonalStorage можна використати для цього. Нижче наведений фрагмент коду показує, як витягти вкладення без витягнення повного повідомлення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
string dataDir = RunExamples.GetDataDir_Outlook();

using (PersonalStorage personalstorage = PersonalStorage.FromFile(dataDir + "Outlook.pst"))
{
    FolderInfo folder = personalstorage.RootFolder.GetSubFolder("Inbox");

    foreach (var messageInfo in folder.EnumerateMessagesEntryId())
    {
        MapiAttachmentCollection attachments = personalstorage.ExtractAttachments(messageInfo);

        if (attachments.Count != 0)
        {
            foreach (var attachment in attachments)
            {
                if (!string.IsNullOrEmpty(attachment.LongFileName))
                {
                    if (attachment.LongFileName.Contains(".msg"))
                    {
                        continue;
                    }
                    else
                    {
                        attachment.Save(dataDir + @"\Attachments\" + attachment.LongFileName);
                    }
                }
            }
        }
    }
}

Отримати отримувачів повідомлення з PST‑файлів

Отримувачі повідомлення можна отримати з PST‑файлів, використовуючи ідентифікатор запису повідомлення. Ця функція доступна в PersonalStorage клас. Нижче наведені приклади коду, які демонструють, як отримати отримувачів повідомлення:

за EntryD (використовуючи ExtractRecipients(string entryId) метод PersonalStorage клас)

using (var pst = PersonalStorage.FromFile(fileName))
{  
    // Recipients are extracted using the entry ID
    var recipients = pst.ExtractRecipients("AAAAADzSMygQQFJOkKwVhb8v5EUkASAA");
}

з MessageInfo (використовуючи MapiRecipientCollection ExtractRecipients(MessageInfo messageInfo) метод)

using (var pst = PersonalStorage.FromFile(fileName))
{  
    // The "Inbox" folder is obtained
    var folder = pst.RootFolder.GetSubfolder("Inbox");

    // Each message in the "Inbox" folder is iterated
    foreach (var messageInfo in folder.EnumerateMessages())
    {
        // Recipients are extracted from each message
        var recipients = pst.ExtractRecipients(messageInfo);
    }
}

Пошук повідомлень та папок

Пошук за критерієм

Файли Personal Storage (PST) можуть містити величезну кількість даних. Пошук даних, які відповідають певному критерію у таких великих файлах, потребує включення декількох контрольних точок у коді для фільтрації інформації. За допомогою PersonalStorageQueryBuilder клас, Aspose.Email дозволяє шукати конкретні записи в PST на основі заданого критерію пошуку. У PST можна шукати повідомлення за параметрами пошуку, такими як відправник, одержувач, тема, важливість повідомлення, наявність вкладень, розмір повідомлення та навіть ID повідомлення. PersonalStorageQueryBuilder також можна використати для пошуку підпапок.

Пошук повідомлень і папок у PST

Наступний фрагмент коду показує, як використовувати PersonalStorageQueryBuilder клас для пошуку вмісту в PST на основі різних критеріїв пошуку. Наприклад, показано пошук у PST за:

Важливість повідомлення.
Клас повідомлення.
Наявність вкладень.
Розмір повідомлення.
Непрочитані повідомлення.
Непрочитані повідомлення з вкладеннями, та
папки із конкретною назвою підпапки.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();

using (PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir + "Outlook.pst"))
{
    FolderInfo folder = personalStorage.RootFolder.GetSubFolder("Inbox");
    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();

    // High importance messages
    builder.Importance.Equals((int)MapiImportance.High);
    MessageInfoCollection messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Messages with High Imp:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    builder.MessageClass.Equals("IPM.Note");
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Messages with IPM.Note:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Messages with attachments AND high importance
    builder.Importance.Equals((int)MapiImportance.High);
    builder.HasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Messages with atts: " + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Messages with size > 15 KB
    builder.MessageSize.Greater(15000);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("messags size > 15Kb:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Unread messages
    builder.HasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Unread:" + messages.Count);

    builder = new PersonalStorageQueryBuilder();
    // Unread messages with attachments
    builder.HasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    builder.HasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.GetContents(builder.GetQuery());
    Console.WriteLine("Unread msgs with atts: " + messages.Count);

    // Folder with name of 'SubInbox'
    builder = new PersonalStorageQueryBuilder();
    builder.FolderName.Equals("SubInbox");
    FolderInfoCollection folders = folder.GetSubFolders(builder.GetQuery());
    Console.WriteLine("Folder having subfolder: " + folders.Count);

    builder = new PersonalStorageQueryBuilder();
    // Folders with subfolders
    builder.HasSubfolders();
    folders = folder.GetSubFolders(builder.GetQuery());
    Console.WriteLine(folders.Count);
}

Пошук з параметром ігнорування регістру

Наступний фрагмент коду показує, як шукати рядок у PST з параметром ігнорування регістру.

using (PersonalStorage personalStorage = PersonalStorage.Create("CaseSensitivity.pst", FileFormatVersion.Unicode))
{
	FolderInfo folderinfo = personalStorage.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox);
	folderinfo.AddMessage(MapiMessage.FromMailMessage(MailMessage.Load("Sample.eml")));
	PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();
	// IgnoreCase is True
	builder.From.Contains("automated", true);
	MailQuery query = builder.GetQuery();
	MessageInfoCollection coll = folderinfo.GetContents(query);
	Console.WriteLine(coll.Count);
}

Пошук тем повідомлень за кількома ключовими словами

Ви можете використати MailQueryBuilder.Or метод для пошуку повідомлень із темою, що містить принаймні одне з вказаних слів, як показано нижче:

var builder1 = new PersonalStorageQueryBuilder();
builder1.Subject.Contains("Review"); // 'Review' is key word for the search

var builder2 = new PersonalStorageQueryBuilder();
builder2.Subject.Contains("Error"); // 'Error' is also key word for the search

var queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.Or(builder1.GetQuery(), builder2.GetQuery()); // message subjects must contain 'Review' or 'Error' words

using (var storage = PersonalStorage.FromFile("example.pst"))
{
    var folderInfo = storage.RootFolder.GetSubFolder("Inbox");
    var messageInfos = folderInfo.GetContents(queryBuilder.GetQuery());

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

Маніпулювання повідомленнями

Переміщення елементів у інші папки

Aspose.Email дозволяє переміщати елементи з вихідної папки в іншу папку в тому ж файлі Personal Storage (PST). Це включає:

Переміщення вказаної папки у нову батьківську папку.
Переміщення вказаних повідомлень у нову папку.
Переміщення вмісту у нову папку.
Переміщення підпапок у нову батьківську папку.

Наступний фрагмент коду показує, як перемістити елементи, такі як повідомлення та папки, з вихідної папки в іншу папку в тому ж PST‑файлі.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

using(PersonalStorage personalStorage = PersonalStorage.FromFile("test.pst"))
{
    FolderInfo inbox = personalStorage.GetPredefinedFolder(StandardIpmFolder.Inbox);
    FolderInfo deleted = personalStorage.GetPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo subfolder = inbox.GetSubFolder("Subfolder");

    // Move folder and message to the Deleted Items
    personalStorage.MoveItem(subfolder, deleted);
    MessageInfoCollection contents = subfolder.GetContents();
    personalStorage.MoveItem(contents[0], deleted);

    // Move all inbox subfolders and subfolder contents to the Deleted Items
    inbox.MoveSubfolders(deleted);
    subfolder.MoveContents(deleted);
}

Оновлення властивостей повідомлень

Іноді потрібно оновити певні властивості повідомлень, наприклад, змінити тему, позначити важливість повідомлення тощо. Оновлення повідомлення у PST файлі з такими змінами у властивостях повідомлення можна здійснити за допомогою FolderInfo.ChangeMessages метод. У цій статті показано, як масово оновлювати повідомлення у PST файлі щодо змін у властивостях. Нижче наведений фрагмент коду демонструє, як оновити властивості повідомлень у масовому режимі для декількох повідомлень у PST файлі.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook() + "Sub.pst";

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir);
            
// Get Requierd Subfolder 
FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");

// find messages having From = "someuser@domain.com"
PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.From.Contains("someuser@domain.com");

// Get Contents from Query
MessageInfoCollection messages = inbox.GetContents(queryBuilder.GetQuery());

// Save (MessageInfo,EntryIdString) in List
IList<string> changeList = new List<string>();
foreach (MessageInfo messageInfo in messages)
{
    changeList.Add(messageInfo.EntryIdString);
}

// Compose the new properties
MapiPropertyCollection updatedProperties = new MapiPropertyCollection();
updatedProperties.Add(MapiPropertyTag.PR_SUBJECT_W, new MapiProperty(MapiPropertyTag.PR_SUBJECT_W, Encoding.Unicode.GetBytes("New Subject")));
updatedProperties.Add(MapiPropertyTag.PR_IMPORTANCE, new MapiProperty(MapiPropertyTag.PR_IMPORTANCE, BitConverter.GetBytes((long)2)));

// update messages having From = "someuser@domain.com" with new properties
inbox.ChangeMessages(changeList, updatedProperties);

Оновлення користувацьких властивостей

Іноді необхідно позначити елементи, які були оброблені, у файлі PST. API Aspose.Email дозволяє це робити за допомогою MapiProperty та MapiNamedProperty. Наступні методи допоможуть у цьому.

ctor MapiNamedProperty(long propertyTag, string nameIdentifier, Guid propertyGuid, byte[] propertyValue)
ctor MapiNamedProperty(long propertyTag, long nameIdentifier, Guid propertyGuid, byte[] propertyValue)
FolderInfo.ChangeMessages(MapiPropertyCollection updatedProperties) — змінює всі повідомлення у папці
PersonalStorage.ChangeMessage(string entryId, MapiPropertyCollection updatedProperties) — змінює властивості повідомлення

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

public static void Run()
{
	// Load the Outlook file
	string dataDir = RunExamples.GetDataDir_Outlook() + "Sub.pst";
	using (PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir))
	{
		FolderInfo testFolder = personalStorage.RootFolder.GetSubFolder("Inbox");

		// Create the collection of message properties for adding or updating
		MapiPropertyCollection newProperties = new MapiPropertyCollection();

		// Normal,  Custom and PidLidLogFlags named  property
		MapiProperty property = new MapiProperty(MapiPropertyTag.PR_ORG_EMAIL_ADDR_W,Encoding.Unicode.GetBytes("test_address@org.com"));
		MapiProperty namedProperty1 = new MapiNamedProperty(GenerateNamedPropertyTag(0, MapiPropertyType.PT_LONG),"ITEM_ID",Guid.NewGuid(),BitConverter.GetBytes(123));
		MapiProperty namedProperty2 = new MapiNamedProperty(GenerateNamedPropertyTag(1, MapiPropertyType.PT_LONG),0x0000870C,new Guid("0006200A-0000-0000-C000-000000000046"),BitConverter.GetBytes(0));
		newProperties.Add(namedProperty1.Tag, namedProperty1);
		newProperties.Add(namedProperty2.Tag, namedProperty2);
		newProperties.Add(property.Tag, property);
		testFolder.ChangeMessages(testFolder.EnumerateMessagesEntryId(), newProperties);
	}
}

private static long GenerateNamedPropertyTag(long index, MapiPropertyType dataType)
{
	return (((0x8000 | index) << 16) | (long)dataType) & 0x00000000FFFFFFFF;
}

Видалити повідомлення

У цій статті показано, як використовувати FolderInfo клас для доступу до конкретних папок у PST‑файлі. Щоб видалити повідомлення з підпапки Sent раніше завантаженого або створеного PST‑файлу:

Створіть екземпляр FolderInfo клас і завантаживши його вмістом підпапки Sent.
Видаліть повідомлення з папки Sent, викликавши FolderInfo.DeleteChildItem() метод і передаючи MessageInfo.EntryId як параметр. Наступний фрагмент коду показує, як видалити повідомлення з підпапки Sent у PST‑файлі.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook() + "Sub.pst";

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir);

// Get the Sent items folder
FolderInfo folderInfo = personalStorage.GetPredefinedFolder(StandardIpmFolder.SentItems);

MessageInfoCollection msgInfoColl = folderInfo.GetContents();
foreach (MessageInfo msgInfo in msgInfoColl)
{
    Console.WriteLine(msgInfo.Subject + ": " + msgInfo.EntryIdString);
    if (msgInfo.Subject.Equals("some delete condition") == true)
    {
        // Delete this item
        folderInfo.DeleteChildItem(msgInfo.EntryId);
        Console.WriteLine("Deleted this message");
    }
}

Видалити папки

Ви можете видалити папку PST, перемістивши її до папки Видалені елементи.

using (PersonalStorage pst = PersonalStorage.FromFile(@"test.pst"))
{
    FolderInfo deletedItemsFolder = pst.GetPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo emptyFolder = pst.RootFolder.GetSubFolder("Empty folder");
	  FolderInfo someFolder = pst.RootFolder.GetSubFolder("Some folder");
    pst.MoveItem(emptyFolder, deletedItemsFolder);
	  pst.MoveItem(someFolder, deletedItemsFolder);
}

Перевага цього методу полягає в тому, що видалена папка може бути легко відновлена.

FolderInfo someFolder = deletedItemsFolder.GetSubFolder("Some folder");
pst.MoveItem(someFolder, pst.RootFolder);

За потреби ви також можете назавжди видалити папку з папки Видалені елементи.

deletedItemsFolder.DeleteChildItem(emptyFolder.EntryId);

The DeleteChildItem() метод можна використовувати для будь‑яких папок, якщо ви хочете одразу і назавжди видалити підпапку, минаючи папку Видалені.

FolderInfo someFolder = pst.RootFolder.GetSubFolder("Some folder");
pst.RootFolder.DeleteChildItem(someFolder.EntryId);

Видалення елементів з PST

Видаліть елементи (папки або повідомлення) з Personal Storage Table (PST), використовуючи унікальний entryId, пов’язаний з елементом, викликавши метод DeleteItem(string entryId) у PersonalStorage клас.

Наведений нижче фрагмент коду можна використати для виклику методу DeleteItem та передати entryId як параметр:

var pst = PersonalStorage.FromFile("sample.pst");

// ...

pst.DeleteItem(entryId);

// ...

Зверніть увагу:

Цей метод назавжди видалить елемент з PST і його неможливо буде відновити. Будьте обережні, використовуючи цей метод, щоб уникнути випадкової втрати даних.
Відповідно до стандартних конвенцій, переконайтеся, що entryId є дійсним і відповідає існуючому елементу в PST.
Інше, буде кинуто виключення. Рекомендовано мати резервну копію PST або впровадити відповідні заходи для відновлення видалених елементів за потреби.

Масове видалення

API Aspose.Email можна використати для масового видалення елементів з PST‑файла. Це здійснюється за допомогою DeleteChildItems() метод, який приймає список елементів Entry ID, що вказують на елементи для видалення. Наступний фрагмент коду показує, як масово видаляти елементи з PST‑файла.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook() + @"Sub.pst";
using (PersonalStorage personalStorage = PersonalStorage.FromFile(dataDir))
{
    // Get Inbox SubFolder from Outlook file
    FolderInfo inbox = personalStorage.RootFolder.GetSubFolder("Inbox");

    // Create instance of PersonalStorageQueryBuilder
    PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();

    queryBuilder.From.Contains("someuser@domain.com");
    MessageInfoCollection messages = inbox.GetContents(queryBuilder.GetQuery());
    IList<string> deleteList = new List<string>();
    foreach (MessageInfo messageInfo in messages)
    {
        deleteList.Add(messageInfo.EntryIdString);
    }

    // delete messages having From = "someuser@domain.com"
    inbox.DeleteChildItems(deleteList);
}

Відновлення м’яко видалених елементів з файлів PST та OST

Aspose.Email для .NET надає метод відновлення м’яко видалених елементів з файлів PST та OST. Ця функціональність реалізована через PersonalStorage клас, який включає FindAndExtractSoftDeletedItems метод. Цей метод дозволяє знаходити та відновлювати елементи, які були м’яко видалені, що дає можливість відновити важливі дані, які інакше могли б бути втрачені. Відновлені елементи зберігаються у відповідних папках як .msg файлів, забезпечуючи збереження оригінальної структури папок. Наведений нижче приклад коду демонструє, як реалізувати цю функцію у вашому проєкті:

using (var pst = PersonalStorage.FromFile(fileName))
{
    // Soft deleted items are found and extracted
    var entries = pst.FindAndExtractSoftDeletedItems();

    // The recovered items are iterated through
    for (var index = 0; index < entries.Count; index++)
    {
        // Folder information is obtained by ID
        var folderInfo = pst.GetFolderById(entries[index].FolderId);

        // A directory for the folder is created if it doesn't exist
        if (!Directory.Exists(folderInfo.DisplayName))
        {
            Directory.CreateDirectory(Path.Combine(path, folderInfo.DisplayName));
        }
        
        // The restored item is obtained
        var msg = entries[index].Item;
        
        // The restored item is saved as a .msg file
        msg.Save(Path.Combine(path, folderInfo.DisplayName, $"{index}.msg"));
    }
}

Перерахування м’яко видалених повідомлень у файлах PST

М’яко видалені повідомлення у файлі PST — це елементи, які були видалені двічі: спочатку переміщені до папки Видалені, а потім знову видалені. Такі повідомлення не знищені назавжди і їх все ще можна отримати програмно. Aspose.Email для .NET підтримує отримання цих м’яко видалених повідомлень для перегляду або відновлення.

Для перерахування та відновлення елементів, які були м’яко видалені (видалені двічі) у файлах PST, використовуйте FindAndEnumerateSoftDeletedItems() метод. Цей метод отримує перелік таких елементів, кожен з яких містить повідомлення та ID папки, з якої він був видалений.

Наведений нижче приклад коду демонструє, як перераховувати та відновлювати електронні листи, які були видалені двічі. Він повертає RestoredItemEntry клас, який представляє запис про м’яко видалений елемент, відновлений з файлу PST. Клас містить наступні властивості:

Item (MapiMessage): Відновлений об’єкт повідомлення.
FolderId (string): Ідентифікатор папки, з якої повідомлення було спочатку видалено.

// Load the PST file
using (var pst = PersonalStorage.FromFile("archive.pst"))
{
    // Enumerate soft-deleted items
    foreach (var entry in pst.FindAndEnumerateSoftDeletedItems())
    {
        var message = entry.Item;
        var folderId = entry.FolderId;

        Console.WriteLine($"Subject: {message.Subject}");
        Console.WriteLine($"Deleted from Folder ID: {folderId}");
        Console.WriteLine("-----------------------------------");
    }
}

Розділити файли PST

Розділити на кілька PST

API Aspose.Email надає можливість розділити один файл PST на декілька PST‑файлів бажаного розміру.

Нижче наведений приклад коду, який описує процес розділення файлу:

Спочатку він використовує FromFile метод PersonalStorage клас для вказання імені файлу.
Потім він викликає StorageProcessedEventHandler делегат для обробки події StorageProcessed.
StorageProcessingEventArgs надає дані для події PersonalStorage.StorageProcessing. Його StorageProcessingEventArgs.FileName властивість дозволяє отримати назву файлу PST. Для MergeWith метод, який буде назвою поточного PST, що буде об’єднано з основним, і для SplitInto метод, який буде назвою поточної частини.
Нарешті, SplitInto(long chunkSize, string partFileNamePrefix, string path) Перевантажений метод запустить розділення сховища PST на частини меншого розміру. Він приймає наступні параметри:

chunkSize: Приблизний розмір кожної частини в байтах.
partFileNamePrefix: Префікс, який додається до імені файлу кожної частини PST. Якщо вказано, префікс додається на початок імені кожного файлу. Якщо не вказано (null або порожньо), частини PST будуть створені без префікса.
path: Шлях до папки, у якій будуть створені частини.

Ім’я файлу кожної частини відповідає шаблону: {prefix}part{number}.pst, де {prefix} — префікс імені файлу (за наявності), а {number} — номер частини файлу.

var pst = PersonalStorage.FromFile("sample.pst");

// ...

pst.StorageProcessing += (sender, args) =>
{
    Console.WriteLine("Storage processing event raised for file: " + args.FileName);
};

// ...

pst.SplitInto(5000000, "prefix_", outputFolderPath);

Розділити PST за вказаним критерієм

Наведений нижче фрагмент коду показує, як розділити PST за вказаним критерієм.

Об’єднати PST‑файли

Об’єднати в один PST

Він також може об’єднати кілька PST‑файлів у один PST‑файл. І розділення, і об’єднання PST‑операцій можна відстежувати, додаючи події до цих операцій.

Нижче наведений фрагмент коду показує, як об’єднати в один PST.

Спробуйте!

Об’єднайте та злийте кілька поштових файлів онлайн в один за допомогою безкоштовного Додаток Aspose.Email Merger.

Об’єднати папки з іншого PST

Нижче наведений фрагмент коду показує, як об’єднати папки з іншого PST.

Net: Керування контактами у PST‑файлах

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

Додавання та збереження контактів

Додавання контактів до PST

Розділ Створення і керування файлами PST показує, як створити PST‑файл та додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiContact у підпапку Contacts PST‑файлу, який ви створили або завантажили. Нижче наведено кроки додавання MapiContact до PST:

Створіть MapiContact об’єкт.
Встановіть Властивості MapiContact використовуючи різні конструктори та методи.
Створіть PST за допомогою PersonalStorage.Create() метод.
Створіть заздалегідь визначену папку (Contacts) у корені файлу PST, отримавши доступ до кореневої папки і викликавши AddMapiMessageItem() метод.

Наступний фрагмент коду показує, як створити MapiContact і потім додати його у папку контактів новоствореного файлу PST.

// Create three Contacts 
var contact1 = new MapiContact("Sebastian Wright", "SebastianWright@dayrep.com");
var contact2 = new MapiContact("Wichert Kroos", "WichertKroos@teleworm.us", "Grade A Investment");
var contact3 = new MapiContact("Christoffer van de Meeberg", "ChristoffervandeMeeberg@teleworm.us", "Krauses Sofa Factory", "046-630-4614046-630-4614");

// Contact #4
var contact4 = new MapiContact{NameInfo = new MapiContactNamePropertySet("Margaret", "J.", "Tolle")};
contact4.PersonalInfo.Gender = MapiContactGender.Female;
contact4.ProfessionalInfo = new MapiContactProfessionalPropertySet("Adaptaz", "Recording engineer");
contact4.PhysicalAddresses.WorkAddress.Address = "4 Darwinia Loop EIGHTY MILE BEACH WA 6725";
contact4.ElectronicAddresses.Email1 = new MapiContactElectronicAddress("Hisen1988", "SMTP", "MargaretJTolle@dayrep.com");
contact4.Telephones.BusinessTelephoneNumber = "(08)9080-1183";
contact4.Telephones.MobileTelephoneNumber = "(925)599-3355(925)599-3355";

// Contact #5
var contact5 = new MapiContact{NameInfo = new MapiContactNamePropertySet("Matthew", "R.", "Wilcox")};
contact5.PersonalInfo.Gender = MapiContactGender.Male;
contact5.ProfessionalInfo = new MapiContactProfessionalPropertySet("Briazz", "Psychiatric aide");
contact5.PhysicalAddresses.WorkAddress.Address = "Horner Strasse 12 4421 SAASS";
contact5.Telephones.BusinessTelephoneNumber = "0650 675 73 300650 675 73 30";
contact5.Telephones.HomeTelephoneNumber = "(661)387-5382(661)387-5382";

// Contact #6
var contact6 = new MapiContact
{
    NameInfo = new MapiContactNamePropertySet("Bertha", "A.", "Buell"),
    ProfessionalInfo = new MapiContactProfessionalPropertySet("Awthentikz", "Social work assistant")
};
contact6.PersonalInfo.PersonalHomePage = "B2BTies.com";
contact6.PhysicalAddresses.WorkAddress.Address = "Im Astenfeld 59 8580 EDELSCHROTT";
contact6.ElectronicAddresses.Email1 = new MapiContactElectronicAddress("Experwas", "SMTP", "BerthaABuell@armyspy.com");
contact6.Telephones = new MapiContactTelephonePropertySet("06605045265");

using (PersonalStorage personalStorage = PersonalStorage.Create("SampleContacts_out.pst", FileFormatVersion.Unicode))
{
    var contactFolder = personalStorage.CreatePredefinedFolder("Contacts", StandardIpmFolder.Contacts);
    contactFolder.AddMapiMessageItem(contact1);
    contactFolder.AddMapiMessageItem(contact2);
    contactFolder.AddMapiMessageItem(contact3);
    contactFolder.AddMapiMessageItem(contact4);
    contactFolder.AddMapiMessageItem(contact5);
    contactFolder.AddMapiMessageItem(contact6);
}

Збереження контактів у форматі MSG

У цій статті пояснюється, як отримати інформацію про контакти з Outlook PST‑файлу та зберегти контакт на диск у форматі MSG. Кроки для отримання інформації про контакти:

Завантажте файл PST у PersonalStorage об’єкт.
Перегляньте папку Contacts.
Отримайте вміст папки Contacts, перебираючи повідомлення.
Перевірте, що MessageInfo.MessageClass значення властивості відповідає "IPM.Contact".
Викличте PersonalStorage.ExtractMessage() метод для отримання MapiMessage об’єкт.
Викличте метод MapiMessage.Save(), щоб зберегти контакт на диск у форматі MSG.

Наступний фрагмент коду показує, як отримати всю контактну інформацію з файлу PST і зберегти її на диск у форматі MSG.

// Load the Outlook PST file
var pst = PersonalStorage.FromFile("SampleContacts.pst");

// Get the Contacts folder
var contactsFolder = pst.RootFolder.GetSubFolder("Contacts");

// Loop through all the contacts in this folder
foreach (MessageInfo messageInfo in contactsFolder.EnumerateMessages())
{
    if (messageInfo.MessageClass == "IPM.Contact")
    {
        // Get the contact information
        var msg = pst.ExtractMessage(messageInfo);
        
        // Save to disk in msg format
        string contactName = msg.Subject.Replace(":", " ").Replace("\\", " ").Replace("?", " ").Replace("/", " ");
        msg.Save($"{contactName}.msg", SaveOptions.DefaultMsgUnicode);
    }
}

Збереження контактів у форматі VCF

У цій статті показано, як отримати інформацію про контакти з Microsoft Outlook PST‑файлу та зберегти контакт на диск у форматі vCard (VCF). Використовуйте PersonalStorage і MapiContact класи для отримання інформації про контакти з PST‑файлу. Щоб отримати інформацію про контакти:

Завантажте файл PST у PersonalStorage клас.
Перегляньте папку Contacts.
Отримайте вміст папки Contacts, перебираючи повідомлення.
Перевірте, що MessageInfo.MessageClass значення властивості відповідає "IPM.Contact".
Викличте PersonalStorage.ExtractMessage() метод для отримання MapiMessage об’єкт.
Викличте MapiMessage.ToMapiMessageItem() і приведіть до типу IMapiMessageItem до MapiContact тип.
Викличте MapiContact.Save() метод для збереження контакту на диск у форматі VCard.

Програма нижче завантажує файл PST з диска та зберігає всі контакти у форматі vCard (VCF). Потім файли VCF можна використовувати в будь‑якій іншій програмі, яка підтримує стандартний файл контакту vCard. Якщо відкрити будь‑який файл VCF у Microsoft Outlook, він виглядає так, як на скриншоті нижче.

Наступний фрагмент коду показує, як експортувати контакти з Outlook PST у формат vCard (VCF).

// Load the Outlook PST file
var pst = PersonalStorage.FromFile("SampleContacts.pst");

// Get the Contacts folder
var contactsFolder = pst.RootFolder.GetSubFolder("Contacts");

// Loop through all the contacts in this folder
foreach (MessageInfo messageInfo in contactsFolder.EnumerateMessages())
{
    if (messageInfo.MessageClass == "IPM.Contact")
    {
        // Get the contact information
        var msg = pst.ExtractMessage(messageInfo);
        var contact = (MapiContact)msg.ToMapiMessageItem();

        // Display some contents on screen
        Console.WriteLine("Name: " + contact.NameInfo.DisplayName);

        // Save to disk in VCard format
        string contactName = contact.Subject.Replace(":", " ").Replace("\\", " ").Replace("?", " ").Replace("/", " ");
        contact.Save($"{contactName}.vcf", ContactSaveFormat.VCard);
    }
}

Дивіться також: Керування списками розсилки у файлах PST

Net: Керування списками розсилки у файлах PST

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

Створення та керування списками розсилки

Створити та зберегти списки розсилки

Можна створити список розсилки за допомогою Aspose.Email API, який є колекцією кількох контактів. Список розсилки можна зберегти на диск у форматі Outlook MSG і переглянути/обробити, відкривши його в MS Outlook. Наведений фрагмент коду показує, як створити та зберегти список розсилки.

Читання списків розсилки

Наступний фрагмент коду показує, як прочитати розсилковий список з PST.

using Aspose.Email.Storage.Pst;
using Aspose.Email.Mapi;

// Load the PST file
using (var pst = PersonalStorage.FromFile("your.pst"))
{
    // Get the Contacts folder
    var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);

    if (folder != null)
    {
        foreach (var msgInfo in folder.EnumerateMessages())
        {
            // Check if the message has the "IPM.DistList" message class
            if (msgInfo.MessageClass == "IPM.DistList")
            {
                // Extract the distribution list
                var distList = (MapiDistributionList)pst.ExtractMessage(msgInfo).ToMapiMessageItem();
                
                // Now, you can work with the distribution list
                // (e.g., access its members, display its properties, or make modifications)
            }
        }
    }
}

Оновлення списків розсилки

Наведений фрагмент коду показує, як оновити список розсилки у PST.

using Aspose.Email.Mapi;
using Aspose.Email.Storage.Pst;

// Load PST file
using (PersonalStorage pst = PersonalStorage.FromFile("my.pst"))
{
    // Get Contacts folder
    var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);

    // Add a new member to each distribution list in PST
    foreach (var msg in folder.EnumerateMessages())
    {
        // Check if the message has the "IPM.DistList" message class
        if (msg.MessageClass == "IPM.DistList")
        {
            var distList = pst.ExtractMessage(msg).ToMapiMessageItem();

            // Create a new member to add
            var member = new MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com");
            distList.Members.Add(member);

            // Update Distribution List in PST
            folder.UpdateMessage(msg.EntryIdString, distList);
        }
    }
}

Net: Керування елементами календаря у PST‑файлах

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

Додавання MAPI календаря до PST

Створення і керування файлами PST показує, як створити PST‑файл та додати до нього підпапку. За допомогою Aspose.Email ви можете додати MapiCalendar у підпапку Calendar PST‑файлу, який ви створили або завантажили. Нижче наведено кроки додавання MapiCalendar до PST:

Створіть MapiCalendar об’єкт.
Встановіть MapiCalendar властивості за допомогою конструктора та методів.
Створіть PST за допомогою PersonalStorage.Create() метод.
Створіть заздалегідь визначену папку (Calendar) у корені PST файлу, отримавши доступ до кореневої папки і потім викликавши AddMapiMessageItem() метод.

Наведений фрагмент коду показує, як створити MapiCalendar а потім додати його до папки календаря новоствореного PST‑файлу.

Збереження елементів календаря на диск у форматі ICS

У цій статті показано, як отримати елементи календаря з Outlook PST‑файлу та зберегти календар на диск у форматі ICS. Використовуйте PersonalStorage і MapiCalendar класи для отримання інформації про календар. Нижче наведено кроки збереження елементів календаря:

Завантажте файл PST у PersonalStorage клас.
Перегляньте папку Calendar.
Отримайте вміст папки Calendar, щоб отримати колекцію повідомлень.
Переберіть колекцію повідомлень.
Викличте PersonalStorage.ExtractMessage() метод для отримання інформації про контакт у MapiCalendar клас.
Викличте MapiCalendar.Save() метод для збереження елемента календаря на диск у форматі ICS.

Програма нижче завантажує файл PST з диска та зберігає всі елементи календаря у форматі ICS. Потім файли ICS можна використовувати в будь‑якій іншій програмі, яка підтримує стандартний файл календаря ICS. У Microsoft Outlook файл ICS виглядає так, як на скриншоті нижче.

Наступний фрагмент коду показує, як експортувати елементи календаря з Outlook PST у формат ICS.

Збереження з оригінальним часовим міткою

Доступні наступні можливості збереження елементів календаря у форматі ICS з збереженням їхньої оригінальної дати та часу:

MapiCalendarIcsSaveOptions - Дозволяє вказувати додаткові параметри при збереженні MapiCalendar у форматі Ics.
MapiCalendarIcsSaveOptions.KeepOriginalDateTimeStamp - Дозволяє зберігати оригінальне значення DateTimeStamp у вихідному файлі.

Використайте наведенний нижче приклад коду, щоб впровадити функції у ваш проект:

var cal = pst.ExtractMessage(msgInfo).ToMapiMessageItem() as MapiCalendar;

if (cal != null)
{
  cal.Save("cal.ics", new MapiCalendarIcsSaveOptions() { KeepOriginalDateTimeStamp = true});
}

Модифікувати/Видаляти повторення з рекурентних подій

Виключення можна додавати до існуючих повторень за допомогою Aspose.Email for .NET API. Нижче наведено приклад коду, що ілюструє використання цієї можливості.

Net: Керування завданнями, журналами та нотатками у файлах PST

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

Додати MAPI завдання до PST

The Створення і керування файлами PST стаття показує, як створити файл PST і додати до нього підтеку. За допомогою Aspose.Email ви можете додати MapiTask у підтеці Tasks файлу PST, який ви створили або завантажили. Нижче наведено кроки для додавання MapiTask у PST:

Створіть MapiTask об’єкт.
Встановіть MapiTask властивості, використовуючи конструктор та різні методи.
Створіть PST за допомогою PersonalStorage.Create() метод.
Створіть заздалегідь визначену папку (Tasks) у корені PST файлу, отримавши доступ до кореневої папки і потім викликавши AddMapiMessageItem() метод.

Наведений фрагмент коду показує, як створити MapiTask а потім додати його до теки завдань новоствореного файлу PST.

Додати MAPI журнал до PST

Aspose.Email також дозволяє додавати MapiJournal у підтеці Journal файлу PST, який ви створили або завантажили. Нижче наведено кроки для додавання MapiJournal у PST:

Створіть MapiJournal об’єкт
Встановіть MapiJournal властивості за допомогою конструктора та методів.
Створіть PST за допомогою PersonalStorage.Create() метод.
Створіть заздалегідь визначену папку (Journals) у корені файлу PST, отримавши доступ до кореневої папки, а потім викликавши AddMapiMessageItem() метод.

Наведений фрагмент коду показує, як створити MapiJournal а потім додати його до теки журналу новоствореного файлу PST.

Додати вкладення до MAPI журналу

Наведений фрагмент коду показує, як додати вкладення до MapiJournal.

Додати MAPI нотатку до PST

За допомогою Aspose.Email ви можете додати MapiNote у підтеку Notes створеного або завантаженого файлу PST. Щоб додати MapiNote у PST:

Створити шаблон MapiNote використовуючи Microsoft Outlook і збережіть її як файл MSG.
Завантажте збережену нотатку MSG у MapiMessage об’єкт.
Створіть MapiNote об’єкт і завантажте шаблон нотатки MSG.
Встановіть Властивості MapiNote.
Створіть PST за допомогою PersonalStorage.Create() метод.
Створіть заздалегідь визначену папку (Notes) у корені PST файлу, отримавши доступ до кореневої папки і потім викликавши AddMapiMessageItem() метод.

Наведений фрагмент коду показує, як створити MapiNote а потім додати його до теки нотаток новоствореного файлу PST.

Net: Робота з захистом PST паролем

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

Робота з захистом PST паролем

Microsoft Outlook дозволяє користувачам захищати PST‑файли паролем, обмежуючи до них доступ. Aspose.Email може виявляти захист паролем у PST‑файлі. Захист паролем реалізовано лише в Outlook; дані фактично не шифруються. Це дозволяє використовувати API для витягнення листів без знання пароля.

Спробуйте!

Запустіть PstPasswordManager простий проєкт додатку, і ознайомитися з можливостями Aspose.Email щодо управління паролями PST.

Читання PST‑файлів, захищених паролем

Ви можете читати файли, захищені паролем, як звичайні незахищені pst‑файли.

using var pst = PersonalStorage.FromFile(fileName);
foreach (var folder in pst.RootFolder.GetSubFolders())
{
    foreach (var msg in folder.EnumerateMessages())
    {

    }
}

Перевірка, чи захищений PST паролем

API надає PersonalStorage.Store.IsPasswordProtected властивість. Цей PersonalStorage.Store.IsPasswordProtected властивість повертає true, якщо PST‑файл захищений паролем, і false, якщо ні.

Нижче наведений фрагмент коду демонструє використання PersonalStorage.Store.IsPasswordProtected властивість.

using var pst = PersonalStorage.FromFile("passwordprotectedPST.pst");
Console.WriteLine($"The storage is password protected - {pst.Store.IsPasswordProtected}");

Перевірка пароля

The PersonalStorage.Store.IsPasswordValid() метод приймає рядок пароля як параметр і повертає true, якщо пароль вірний, і false, якщо неправильний.

Нижче наведений фрагмент коду демонструє використання PersonalStorage.Store.IsPasswordValid() метод.

using var pst = PersonalStorage.FromFile("passwordprotectedPST.pst");
Console.WriteLine($"Password is valid - {pst.Store.IsPasswordValid("Password1")}");

Додати/Змінити/Видалити паролі

The PersonalStorage.Store.ChangePassword метод використовується для додавання, зміни або видалення пароля.

Щоб це зробити, виконайте наступні кроки:

Завантажити PST з файлу або потоку.
Викличте PersonalStorage.Store.ChangePassword метод. Щоб додати чи змінити пароль, передайте рядок пароля як параметр, а щоб видалити пароль — передайте значення null.

using var pst = PersonalStorage.Create("SetPasswordOnPST_out.pst", FileFormatVersion.Unicode);
// Add or change the password
const string password = "Password1";
pst.Store.ChangePassword(password);
// Remove the password
pst.Store.ChangePassword(null);

Net: Читання файлів PST та отримання інформації

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

Читання PST‑файлів та отримання інформації

Aspose.Email for .NET надає API для читання файлів Microsoft Outlook PST. Ви можете завантажити файл PST з диска або потоку в екземпляр PersonalStorage клас і отримати інформацію про його вміст, наприклад, папки, підпапки та повідомлення. API також надає можливість включати папки пошуку під час обходу повідомлень у PST‑папках.

Завантаження PST‑файлу

Файл Outlook PST можна завантажити в екземплярі PersonalStorage клас. Наступний фрагмент коду показує, як завантажити файл PST.

Відображення інформації про папки

Після завантаження PST‑файлу в PersonalStorage клас, ви можете отримати інформацію про назву файлу, кореневу папку, підпапки та кількість повідомлень. Наступний фрагмент коду показує, як відобразити назву PST‑файлу, папки та кількість повідомлень у папках.

Отримати лише користувацькі папки

Файли PST/OST можуть містити папки, створені користувачем. Aspose.Email надає можливість доступу лише до папок, визначених користувачем, за допомогою PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser властивості. Ви можете встановити PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser встановіть властивість у true, щоб отримати лише користувачем визначені папки. Нижче наведено приклад коду, який демонструє використання PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser для отримання користувачем визначених папок.

Перевірка, чи папка є попередньо визначеною

При відкритті та перевірці папок у файлі PST (Personal Storage Table) ви можете перевірити, чи є кожна папка заздалегідь визначеною, чи підпапкою заздалегідь визначеної папки, та отримати інформацію про кожну папку.

The FolderInfo.GetPredefinedType(bool getForTopLevelParent) метод дозволяє перевірити, чи папка є з StandardIpmFolder. Якщо параметр getForTopLevelParent true, метод повертає StandardIpmFolder значення enum для батьківської папки верхнього рівня. Це визначає, чи є поточна папка підпапкою попередньо визначеної папки. Якщо параметр getForTopLevelParent false, повертає StandardIpmFolder значення enum для поточної папки.

Наступний приклад коду показує, як впровадити цю функцію у ваш проєкт:

PersonalStorage.FromFile("my.pst"))
        {
            FolderInfoCollection folders = pst.RootFolder.GetSubFolders();

            foreach (FolderInfo folder in folders)
            {
                Console.WriteLine($"Folder: {folder.DisplayName}");
                Console.WriteLine($"Is predefined: {folder.GetPredefinedType(false) != StandardIpmFolder.Unspecified}");
                Console.WriteLine("-----------------------------------");
            }
        }

Отримання інформації про батьківську папку

Наведений нижче приклад коду показує, як отримати інформацію про батьківську папку з MessageInfo.

Отримати підпапку за шляхом

The FolderInfo.GetSubFolder(string name, bool ignoreCase, bool handlePathSeparator) Перевантаження методу дозволить вам отримати підпапку з вказаною назвою з поточної PST‑папки.

Метод приймає такі параметри:

name - вказує назву підпапки, яку необхідно отримати.
ignoreCase - визначає, чи пошук назви підпапки має бути чутливим до регістру чи ні. Якщо встановлено true, пошук буде нечутливим до регістру, інакше — чутливим.
handlePathSeparator - вказує, чи слід розглядати зазначену назву папки як шлях, якщо вона містить зворотні косі риски. Якщо встановлено true, метод інтерпретує назву папки як шлях, намагаючись перейти до підпапки за допомогою шляху. Якщо встановлено false, метод розглядатиме назву папки як просту назву, шукаючи підпапку з точним збігом імені.

Наступний приклад коду демонструє, як реалізувати цей метод у вашому проєкті:

var folder = pst.RootFolder.GetSubFolder(@"Inbox\Reports\Jan", true, true);
In this sample, the method will return a ‘Jan’ named folder that is located at the Inbox\Reports\ path relative to the root folder.

RSS-канали та папки, що підлягають пошуку

Стандартна папка RSS Feeds у PersonalStorage

Aspose.Email дозволяє отримати посилання на заздалегідь визначену папку, яка містить RSS-стрічки. Це може бути корисно, якщо ви хочете програмно отримати доступ і маніпулювати RSS-стрічками, збереженими у файлі Outlook PST. Присвойте значення RssFeeds до StandardIpmFolder перелічення.

Наступний приклад коду показує, як отримати папку RSS Feeds.

using (var pst = PersonalStorage.FromFile("my.pst", false))
{
    var rssFolder = pst.GetPredefinedFolder(StandardIpmFolder.RssFeeds);
}

Щоб додати папку RSS Feeds, використайте наступний фрагмент коду:

using (var pst = PersonalStorage.Create("my.pst", FileFormatVersion.Unicode))
{
    var rssFolder = pst.CreatePredefinedFolder("RSS Feeds", StandardIpmFolder.RssFeeds);
}

Розбір пошукових папок

Файл PST/OST може містити пошукові папки, окрім звичайних типів папок. Aspose.Email надає FolderKind перелічувач для зазначення повідомлень із таких пошукових папок з EnumerateFolders і GetSubFolders методи. Наступний фрагмент коду показує, як аналізувати пошукові папки.

using (PersonalStorage pst = PersonalStorage.FromFile("my.pst"))
        {
            FolderInfoCollection folders = pst.RootFolder.GetSubFolders(FolderKind.Search | FolderKind.Normal);

            // Browse through each folder to display folder name and number of messages
            foreach (FolderInfo folder in folders)
            {
                Console.WriteLine($"Folder: {folder.DisplayName}");

                FolderInfoCollection subFolders = folder.GetSubFolders(FolderKind.Search | FolderKind.Normal);
                foreach (FolderInfo subFolder in subFolders)
                {
                    Console.WriteLine($"Sub-folder: {subFolder.DisplayName}");
                }
            }
        }

API обходу PST‑файлів

API обходу дозволяє витягнути всі елементи PST настільки далеко, наскільки це можливо, без виникнення виключень, навіть якщо частина даних оригінального файлу пошкоджена. Нижче наведено кроки щодо використання цього API.

Використати PersonalStorage конструктор і Load метод замість методу FromFile.

Конструктор дозволяє визначити метод зворотного виклику.

using (var currentPst = new PersonalStorage((exception, itemId) => { /* Exception handling  code. */ }))

Винятки під час завантаження та обходу будуть доступні через метод зворотного виклику.

The Load метод повертає ’true’, якщо файл успішно завантажено і подальший обход можна виконати. Якщо файл пошкоджений і обхід неможливий, повертається ‘false’.

if (currentPst.Load(inputStream))

Це дозволяє відкривати та обходити навіть пошкоджені PST‑файли без викидання виключень. Винятки та пошкоджені елементи будуть оброблятися методом зворотного виклику.

using (PersonalStorage pst = new PersonalStorage((exception, itemId) => { /* Exception handling  code. */ }))
{
    if (pst.Load(@"test.pst"))
    {
        GetAllMessages(pst, pst.RootFolder);
    }
}

private static void GetAllMessages(PersonalStorage pst, FolderInfo folder)
{
    foreach (var messageEntryId in folder.EnumerateMessagesEntryId())
    {
        MapiMessage message = pst.ExtractMessage(messageEntryId);
    }
    foreach (var subFolder in folder.GetSubFolders())
    {
        GetAllMessages(pst, subFolder);
    }
}

Отримання кольорів категорій елементів з PST‑файлів

Aspose.Email дозволяє користувачам отримувати інформацію про категорії, включаючи назви та кольори, з PST‑файлів. Дані категорій можна витягти та зіставити з окремими елементами PST. Використовуйте такі члени API:

OutlookCategoryColor enum — представляє колір, пов’язаний з категорією.
PstItemCategory клас — надає властивості для назви та кольору категорії.
GetCategories метод — отримує список категорій з їхніми назвами та кольорами.

Наступні приклади коду демонструють, як отримати всі доступні категорії з PST‑файлу та зіставити їх з певним електронним листом.

Отримання доступних категорій з PST

using (var pst = PersonalStorage.FromFile("mailbox.pst"))
{
   var categories = pst.GetCategories();
   
   foreach(var category in categories)
   {
       Console.WriteLine(category);
   }
}

Відповідність назви категорії її кольору

using (var pst = PersonalStorage.FromFile("mailbox.pst"))
{
    // Get all categories from the PST
    var availableCategories = pst.GetCategories();
    
    // Extract a message from the PST and retrieve the list of category names for the message
    var messageCategoryList = FollowUpManager.GetCategories(pst.ExtractMessage(messageInfo));
    
    // Iterate through each category in the message and match it with the PST category list
    foreach (var messageCategory in messageCategoryList)
    {
        var category = availableCategories.Find(c => c.Name.Equals(messageCategory, StringComparison.OrdinalIgnoreCase));

        if (category != null)
        {
            // Print the category name and its associated color
            Console.WriteLine(category);
        }
        else
        {
            Console.WriteLine($"Category: {messageCategory}, Color: Not found");
        }
    }
}

Net: Читання пошкоджених PST/OST файлів

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

Обробка пошкоджених файлів сховища

Іноді може бути неможливо прочитати PST/OST через певні проблеми. Наприклад, деякі блоки даних можуть бути пошкоджені. У таких випадках під час виклику методу зазвичай виникають виключення EnumerateFolders, EnumerateMessages, GetContents, GetSubfolders, тощо. методи. Але окремі повідомлення або папки можуть залишатися недоторканими у сховищі.

Методи пошуку ідентифікаторів елементів

Наступні методи дозволяють знаходити ідентифікатори елементів ієрархічно.

FindMessages(string parentEntryId) - знаходить ідентифікатори повідомлень для папки.
FindSubfolders(string parentEntryId) - знаходить ідентифікатори підпапок для папки.

Ідентифікатори, отримані за допомогою цих методів, можна використати для отримання повідомлень та папок.

ПРИМІТКА: Слід зазначити, що незважаючи на переваги, існують пошкоджені сховища, які не можна прочитати навіть за допомогою цих методів.

Обхід PST‑файлу

Наступний приклад коду показує обход PST‑файлу та вилучення папок і повідомлень. Щоб отримати список ідентифікаторів, використовуйте методи FindMessages та FindSubfolders. Потім ідентифікатор передається до ExtractMessage або GetFolderById метод для вилучення елементів.

using (var pst = PersonalStorage.FromFile(fileName))
{
    ExploreCorruptedPst(pst, pst.RootFolder.EntryIdString);
}

public static void ExploreCorruptedPst(PersonalStorage pst, string rootFolderId)
{
    var messageIdList = pst.FindMessages(rootFolderId);

    foreach (var messageId in messageIdList)
    {
        try
        {
            var msg = pst.ExtractMessage(messageId);
            Console.WriteLine( "- " + msg.Subject);
        }
        catch
        {
            Console.WriteLine("Message reading error. Entry id: " + messageId);
        }
    }

    var folderIdList = pst.FindSubfolders(rootFolderId);

    foreach (var subFolderId in folderIdList)
    {
        if (subFolderId != rootFolderId)
        {
            try
            {
                FolderInfo subfolder = pst.GetFolderById(subFolderId);
                Console.WriteLine(subfolder.DisplayName);
            }
            catch
            {
                Console.WriteLine("Message reading error. Entry id: " + subFolderId);
            }

            ExplodeCorruptedPst(pst, subFolderId);
        }
    }
}

Net: Робота з великими файлами PST

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

Продуктивність може знижуватися при обробці великих файлів PST. Наступні рішення допоможуть підвищити продуктивність вашого додатка при роботі з великими файлами сховища.

Розгляньте методи, які повертають IEnumerable при обході тек або повідомлень у PST.

using var pst = PersonalStorage.FromFile(@"storage.pst");

foreach (var folder in pst.RootFolder.EnumerateFolders())
foreach (var messageInfo in folder.EnumerateMessages())
{
    // Do something with message
}

Віддавайте перевагу MessageInfo для доступу до базових властивостей повідомлення.

foreach (var messageInfo in folder.EnumerateMessages())
{
    Console.WriteLine($"Subject: {messageInfo.Subject}");
    Console.WriteLine($"To: {messageInfo.DisplayTo}");
    Console.WriteLine($"Importance: {messageInfo.Importance}");
    Console.WriteLine($"Message Class: {messageInfo.MessageClass}");
}

Уникайте використання ExtractMessage або EnumerateMapiMessages методам для всіх повідомлень, якщо тільки не потрібно доступ до всіх властивостей.

Розгляньте використання EnumerateMessagesEntryId для легкого отримання всіх ID повідомлень, що містяться в теці.

foreach (var id in folder.EnumerateMessagesEntryId())
{
  // Use id to retrieve a property (ExtractProperty),
    // extract a MapiMessage (ExtractMessage),
    // extarct message attachments (ExtractAttachments),
    // save msg to a stream(SaveMessageToStream).
}

Розгляньте використання ExtractProperty для читання окремої властивості, якої бракує в MessageInfo.

foreach (var msgId in folder.EnumerateMessagesEntryId())
{
   var transportMessageHeaders =
       pst.ExtractProperty(Convert.FromBase64String(msgId), KnownPropertyList.TransportMessageHeaders.Tag)
           .GetString();
}

Розгляньте використання ExtractAttachments якщо потрібні лише вкладення.

foreach (var msgId in folder.EnumerateMessagesEntryId())
{
   var attachments = pst.ExtractAttachments(msgId);
}

Використати Пошук за критеріямифільтрація на основі - для отримання потрібних вам повідомлень.

using var pst = PersonalStorage.FromFile(@"storage.pst");

var builder = new PersonalStorageQueryBuilder();
// Unread messages
builder.HasNoFlags(MapiMessageFlags.MSGFLAG_READ);

foreach (var folder in pst.RootFolder.EnumerateFolders())
{
    var unread = folder.GetContents(builder.GetQuery());
}

Розгляньте використання SaveMessageToStream якщо потрібно зберегти повідомлення з PST.

Замість використання:

foreach (var id in folder.EnumerateMessagesEntryId())
{
    var msg = pst.ExtractMessage(id);
    msg.Save(@"message.msg");
}

Використайте:

foreach (var id in folder.EnumerateMessagesEntryId())
{
    pst.SaveMessageToStream(id, File.OpenWrite(@"message.msg"));
}

Віддавайте перевагу пакетним методам, щоб додати або видалити кілька елементів.

Net: Читання та конвертація файлів Outlook

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

Робота з OST‑файлами

Aspose.Email для .NET надає API для читання OST‑файлів Microsoft Outlook. Ви можете завантажити OST‑файл з диска або потоку у екземпляр Aspose.Email.Outlook.Pst.PersonalStorage клас для доступу до його вмісту, такого як папки, підпапки та повідомлення. Microsoft Outlook створює PST‑файл для збереження електронної пошти при використанні POP3 або IMAP серверів. Навпаки, він створює OST‑файл, коли сервером є Microsoft Exchange. OST‑файли також підтримують більші розміри файлів, ніж PST‑файли.

Читання OST‑файлів

Процес читання файлу OST за допомогою Aspose.Email точно такий же, як читання файлу PST. Той самий код може читати як PST, так і OST файли: просто вкажіть правильну назву файлу у PersonalStorage.FromFile() метод. Нижче наведений фрагмент коду показує, як читати файли OST.

Конвертувати OST у PST

Спробуйте!

Конвертуйте електронні листи та архіви повідомлень онлайн безкоштовно Додаток конвертації Aspose.Email.

Aspose.Email дозволяє конвертувати файл OST у PST за допомогою одного рядка коду. Аналогічно, файл OST можна створити з файлу PST, використовуючи той самий рядок коду з FileFormat енумератор. На даний момент API підтримує конвертацію форматів OST у PST крім 2013/2016/2019/2021 та майбутніх версій. Нижче наведений фрагмент коду показує, як конвертувати OST у PST.

Для виконання інших операцій з файлами OST, будь ласка, перегляньте наступні сторінки:

Конвертувати PST у OST

Конвертація з PST у OST не підтримується Aspose.Email, оскільки OST завжди створюється Outlook під час додавання облікового запису та синхронізації з поштовим сервером. Різниця між файлами PST і OST полягає в тому, що PST доступний лише локально. Вміст OST також доступний на поштовому сервері. Тому немає потреби конвертувати PST у OST для локального використання. Проте ви можете імпортувати PST у існуючий обліковий запис за допомогою майстра імпорту/експорту в Outlook.

OLM — це спеціальний формат файлів, який використовується Microsoft Outlook для збереження локальних даних, таких як електронні листи, вкладення, примітки, дані календаря, контакти, завдання, історія та інше. Файли OLM сумісні лише з Outlook для Mac і не можуть бути відкриті або доступні в Outlook для Windows, який використовує формат файлів PST.

Робота з файлами OLM

Відкриття файлів OLM

Файли формату OLM можна відкрити двома способами:

використовуючи конструктор
використовуючи статичний метод FromFile

Існують відмінності у поведінці між цими методами. Дивіться розділ нижче.

Використання конструктора

Щоб відкрити файл, викличте конструктор OlmStorage клас і передайте повну назву файлу або потік як аргумент:

var fileName = "MyStorage.olm";
var olm = new OlmStorage(fileName);

Використання статичного методу FromFile

Щоб відкрити файл, використайте статичний метод FromFile і передайте повне ім’я файлу або потік як аргумент:

var fileName = "MyStorage.olm";
var olm = OlmStorage.FromFile(fileName);

Отримання тек

Щоб отримати доступ до структури каталогів файлу OLM, створіть екземпляр OlmStorage класу, використовуючи його конструктор і передаючи шлях до файлу. Після відкриття файлу, отримайте доступ до його структури каталогів за допомогою FolderHierarchy властивості. Ця властивість повертає список OlmFolder об’єкти, кожен представляє каталог у файлі OLM. Щоб далі досліджувати структуру каталогів, зверніться до SubFolders властивість кожного об’єкта, яка повертає список його підкаталогів. Використовуючи ці властивості, ви можете переміщатися по всій ієрархії каталогів файлу OLM та отримувати доступ до всіх каталогів і підкаталогів, які він містить.

Приклад нижче відображає список усіх тек у ієрархічному порядку:

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

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

При використанні FromFile метод для відкриття файлу OLM, FolderHierarchy властивість за замовчуванням не ініціалізується і повертає null. У цьому випадку викличте метод GetFolders явно, щоб ініціалізувати FolderHierarchy властивість і отримати список каталогів у файлі OLM:

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

Також можна отримати будь-яку теку за назвою:

Викличте GetFolder метод.
Передайте назву теки як перший аргумент і значення, яке вказує, чи ігнорувати регістр під час пошуку теки, як другий параметр.

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

Перелік електронних листів

OlmFolder клас, який представляє папку, має такі методи для отримання списку електронних листів:

EnumerateMessages реалізує ітерацію електронних листів у теці. У цьому випадку кожна ітерація повертає OlmMessageInfo об’єкт, який надає коротку інформацію про електронний лист.
EnumerateMapiMessages, також реалізує ітерацію електронних листів у теці, але в цьому випадку кожна ітерація повертає MapiMessage об’єкт, який представляє саме електронний лист, зі всіма властивостями.

Використання методу EnumerateMessages

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

Використання методу EnumerateMapiMessages

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

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

Інші корисні властивості

Інші корисні властивості класу OlmFolder: HasMessages і MessageCount властивості, які повертають наявність повідомлень у теці та їхню кількість.

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

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

Отримати або встановити дату модифікації повідомлення

Дата зміни представляє дату та час останньої зміни OLM‑повідомлення. Ви можете використати OlmMessageInfo.ModifiedDate властивість для отримання або оновлення значення дати зміни OLM‑повідомлення.

Ось приклад, який демонструє використання властивості:

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

Витягнути електронні листи та елементи

OlmStorage клас має ExtractMapiMessage метод, який дозволяє витягати електронні листи. Цей метод отримує OlmMessageInfo об’єкт.

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

    foreach (var messageInfo in folder.EnumerateMessages())
    {
        if (messageInfo.Date == DateTime.Today)
        {
            // Extracts today's messages form Inbox
            var msg = olm.ExtractMapiMessage(messageInfo);
        }
    }
}

Використання Traversal API

Ви можете витягнути всі елементи з файлу Outlook OLM настільки повністю, наскільки це можливо, без викидання виключень, навіть якщо деякі дані оригінального файлу пошкоджені. Для цього використовуйте OlmStorage(TraversalExceptionsCallback callback) конструктор і Load(string fileName) метод замість методу FromFile. Конструктор дозволяє визначити метод зворотного виклику.

using (var olm = new OlmStorage((exception, id) => { /* Exception handling  code. */ }))

Метод зворотного виклику робить доступними виключення завантаження та обходу.

if (olm.Load(fileName))

Наступний фрагмент коду та кроки показують, як використовувати цей API:

Створіть новий екземпляр OlmStorage клас, передаючи зворотній виклик обробки виключень для обробки будь-яких виключень, що виникають під час процесу.
Завантажте файл OLM, викликуючи Load метод екземпляра OlmStorage.
Якщо файл OLM успішно завантажено, отримайте ієрархію папок, викликавши GetFolders метод на екземплярі OlmStorage. Це повертає список об’єктів OlmFolder.
Викличте метод ExtractItems, передаючи екземпляр OlmStorage та список об’єктів OlmFolder.
У методі ExtractItems перебирайте кожну папку у списку folders.
Якщо папка містить повідомлення (електронні листи), виведіть назву папки у консоль за допомогою Console.WriteLine(folder).
Переберіть повідомлення у поточній папці, викликавши метод EnumerateMessages на екземплярі OlmStorage, передаючи поточну папку як аргумент.
Виведіть тему кожного повідомлення у консоль за допомогою Console.WriteLine(msg.Subject).
Якщо в папці є підпапки, рекурсивно викличте метод ExtractItems ще раз, передаючи екземпляр OlmStorage та підпапки поточної папки.

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, List<OlmFolder> folders)
{
    foreach (var folder in folders)
    {
        if (folder.HasMessages)
        {
            Console.WriteLine(folder);

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

        if (folder.SubFolders.Count > 0)
        {
            ExtractItems(olm, folder.SubFolders);
        }
    }
}

Витягнути повідомлення за ідентифікаторами

Інколи потрібно витягти вибрані повідомлення за ідентифікаторами. Наприклад, ваш застосунок зберігає ідентифікатори в базі даних і витягує повідомлення за запитом. Це ефективний спосіб уникнути перебору всього сховища щоразу, щоб знайти конкретне повідомлення для витягнення. Ця функція доступна для сховищ OLM. EntryId властивість OlmMessageInfo клас отримує ідентифікатор запису повідомлення. Перевантажений ExtractMapiMessage(string id) метод OlmStorage клас отримує повідомлення з OLM.

Нижче наведений код показує, як витягти повідомлення з OLM за ідентифікаторами.

Код виконує такі кроки:

Ініціює цикл foreach для проходу по списку OlmMessageInfo об’єктів. Цикл використовує EnumerateMessages метод об’єкта olmFolder для отримання списку всіх повідомлень у поточній папці, яку ітерують.
Цикл витягує відповідний об’єкт MapiMessage зі сховища, викликаючи ExtractMapiMessage(string id) метод OlmStorage клас, передаючи EntryId поточного повідомлення як параметр.

Отриманий об’єкт MapiMessage можна використовувати для доступу та маніпулювання вмістом повідомлення. Цикл триває, доки всі повідомлення у папці не будуть оброблені.

  foreach (OlmMessageInfo msgInfo in olmFolder.EnumerateMessages())
  {
      MapiMessage msg = storage.ExtractMapiMessage(msgInfo.EntryId);
  }

Отримання шляху папки

Ви також можете отримати шлях до папок у файлі OML. Aspose.Email надає OlmFolder.Path властивість, що повертає шлях до папки. Наступний фрагмент коду демонструє використання OlmFolder.Path властивість для отримання шляхів до папок у файлі OML.

var storage = new OlmStorage("SampleOLM.olm");
PrintPath(storage, storage.FolderHierarchy);

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

        if (folder.SubFolders.Count > 0)
        {
            PrintPath(storage, folder.SubFolders);
        }
    }
}

Підрахунок елементів у папці

Ви також можете підрахувати кількість елементів у папці. Aspose.Email надає OlmFolder.MessageCount властивість, що повертає кількість елементів у папці. Наступний фрагмент коду демонструє використання OlmFolder.MessageCount властивість для отримання кількості елементів у папках файлу OML.

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

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

Отримати загальну кількість елементів у OlmStorage

OlmStorage клас також має GetTotalItemsCount() метод, який повертає загальну кількість повідомлень, що містяться у сховищі OLM.

  using (var olm = new OlmStorage("storage.olm"))
  {
     var count = olm.GetTotalItemsCount();
  }

Отримання кольорів категорій Outlook

Для роботи з кольорами категорій або категоріями елементів Outlook, що зберігаються у OLM‑файлах, Aspose.Email пропонує такі рішення:

OlmItemCategory клас — представляє категорії елементів Outlook, які доступні за їхньою назвою та пов’язаними кольорами у шістнадцятковому форматі.
GetCategories() метод OlmStorage клас — отримує список категорій.

Нижче наведений приклад коду демонструє, як отримати всі використані категорії зі сховища OML:

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

Нижче наведений приклад коду показує, як отримати колір категорії повідомлення:

foreach (var msg in olm.EnumerateMessages(folder))
{
    if (msg.Categories != null)
    {
        foreach (var msgCategory in msg.Categories)
        {
            Console.WriteLine($"Category name: {msgCategory}");
            var categoryColor = cat.First(c => c.Name.Equals(msgCategory, StringComparison.OrdinalIgnoreCase)).Color;
            Console.WriteLine($"Category color: {categoryColor}");
        }
    }
}

Конвертувати OLM у PST

OLM це формат файлу бази даних, який використовується Microsoft Outlook для систем Mac. OLM‑файли зберігають електронні листи, дані календаря, контакти та налаштування програми. OLM‑файл не підтримується Outlook для Windows, тому неможливо відкрити файл Outlook для Mac (OLM) в Outlook для Windows. Якщо ви бажаєте перенести свою поштову скриньку з Outlook для Mac до Outlook для Windows, необхідно конвертувати файл OLM Outlook для Mac у формат PST Outlook.

Кроки коду

Щоб конвертувати OLM‑файл у PST, виконайте наведені нижче кроки:

Створіть екземпляр OlmStorage клас для відкриття вихідного OLM.
Відкрийте вихідний OLM‑файл.
Створіть новий PST‑файл за допомогою Create метод.
Створіть метод GetContainerClass для зіставлення класу повідомлення з класом папки.
Створіть метод AddToPst, який рекурсивно зчитує кожну папку та її повідомлення з OLM за допомогою методу EnumerateMapiMessages і додає їх у PST у тому ж порядку, використовуючи методи AddSubFolder та AddMessage.

Зразок коду

Нижче наведений приклад коду показує, як конвертувати OLM у PST.

Метод Main:

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

Реалізація методу GetContainerClass:

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:

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