Documentation – Робота з файлами сховища Outlook (PST/OST)

Cpp: Створення нового PST‑файлу та додавання підпапок

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

Створення нового PST‑файлу та додавання підпапок

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

Створення нового PST‑файлу.
Зміна класу контейнера папки.

Використовуйте клас PersonalStorage для створення PST‑файлу у певному місці на локальному диску. Щоб створити PST‑файл з нуля:

Створіть PST за допомогою методу PersonalStorage.Create().
Додайте підпапку у корені PST‑файлу, отримавши доступ до кореневої папки та викликавши метод AddSubFolder.

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

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

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

Cpp: Прочитати та конвертувати файл Outlook OST

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

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

Aspose.Email for C++ надає API для читання файлів Microsoft Outlook OST. Ви можете завантажити файл 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 дозволяє конвертувати файл OST у PST за допомогою одного рядка коду. Аналогічно, файл OST можна створити з файлу PST, використовуючи той самий рядок коду з перелічувачем FileFormat. На даний момент API підтримує конвертацію форматів OST у PST, за винятком OST 2013/2016. Нижче наведено фрагмент коду, який показує, як конвертувати OST у PST.

Cpp: Читання файлу Outlook PST та отримання інформації про папки і підпапки

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

Читання файлу Outlook PST та отримання інформації про папки і підпапки

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

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

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

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

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

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

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

Cpp: Розділення та об’єднання файлів PST

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

Розділення та об’єднання PST‑файлів

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

Розділення на кілька PST‑файлів

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

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

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

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

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

Cpp: Робота з елементами календаря у PST файлі

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

Додавання MapiCalendar до PST

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

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

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

Збереження елементів календаря з 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.

Cpp: Робота з контактами у файлі PST

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

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

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

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

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

Збереження інформації про контакти з файлу PST у форматі MSG

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

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

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

Збереження контактної інформації з файлу PST у форматі VCF

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

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

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

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

Робота зі списками розсилки

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

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

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

Читання списку розповсюдження з PST

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

Cpp: Робота з MapiJournal у PST

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

Додавання MapiJournal до PST

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

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

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

Додавання вкладень до MapiJournal

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

Cpp: Робота з MapiNote у PST

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

Додавання MapiNote до 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.

Cpp: Робота з MapiTask у PST

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

Додавання MapiTask до PST

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

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

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

Cpp: Робота з повідомленнями у PST файлі

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Cpp: Робота з властивостями захисту паролем PST

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

Робота зі властивостями захисту паролем PST

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

Видалити/скинути властивість пароля у PST
Встановлення/зміна пароля PST

Видалення/скидання властивості PR_PST_PASSWORD

Видалення властивості PR_PST_PASSWORD неможливе, оскільки інші властивості видаляються зі сховища повідомлень. Натомість потрібно встановити її значення в нуль (0), щоб вона була видалена. Властивість "Store" класу PST дозволляє у цьому випадку отримати доступ до властивостей сховища PST замість MessageStoreProperties. Нижче наведено фрагмент коду, який показує, як видалити/скинути властивість PR_PST_PASSWORD.

Встановлення пароля у PST‑файлах

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