Read and Create Outlook Items

Ця стаття зосереджена на роботі з різними елементами Outlook, включаючи календар, контакт, завдання, журнал, нотатку та списки розсилки. У Aspose.Email для .NET ці елементи представлені такими класами: MapiCalendar, MapiContact, MapiTask, MapiJournal, MapiNote та MapiDistributionList. Ці класи служать обгортками для класу MapiMessage, щоб спростити процес обробки даних елементів з властивостей MAPI, надаючи більш інтуїтивний інтерфейс для доступу та маніпулювання даними елементів.

C# .NET API для виконання завдань, пов’язаних з електронною поштою

Щоб працювати з елементами Outlook програмно на C#, ми будемо використовувати Aspose.Email для .NET, прогресивну бібліотеку, яка дозволяє легко керувати електронними листами, контактами, зустрічами, завданнями та іншими елементами Outlook. Деякі основні функції бібліотеки включають читання та запис електронних листів у різних форматах, управління зустрічами та завданнями, роботу з контактами, інтеграцію з Exchange Server та виконання розширених операцій з електронною поштою. У цій статті блогу ми продемонструємо, як використовувати її для взаємодії з елементами Outlook у рамках .NET-застосунків. Практичні приклади та фрагменти коду надані, щоб допомогти вам зрозуміти та впровадити функціональність Aspose.Email для .NET без зусиль у ваших проектах на C#.

Щоб скористатися можливостями API, ви можете завантажити його DLL або встановити його з NuGet за допомогою наступної команди:

PM> Install-Package Aspose.Email

Загальний підхід

Загальний підхід до роботи з елементами Outlook включає завантаження MapiMesage, перетворення його в конкретний клас елемента Outlook (такий як MapiContact або MapiCalendar) і потім доступ або маніпулювання його властивостями. Цей підхід спрощує роботу з властивостями MAPI та надає прямий спосіб управління різними типами елементів Outlook. З іншого боку, ви завжди можете повернутися до об’єкта MapiMessage, просто викликавши метод GetUnderlyingMessage на будь-якому об’єкті елемента.

Маніпулювання календарними елементами

Елементи календаря Outlook представлені класом MapiCalendar. Клас надає властивості та методи для створення, маніпулювання та управління календарними елементами, такими як зустрічі, наради та події в календарі Outlook. Користувачі можуть використовувати цей клас, щоб легко створювати, модифікувати та взаємодіяти з календарними елементами програмно у своїх .NET-застосунках. У наступних абзацах ви дізнаєтеся, як створювати та читати календарні елементи.

Читання календарних елементів

Приклад коду нижче демонструє, як завантажити файл .msg як об’єкт MapiMessage. Потім він перевіряє, чи завантажене повідомлення є типом календаря, використовуючи властивість SupportedType. Якщо це дійсно елемент календаря, код перетворює повідомлення на об’єкт MapiCalendar і продовжує виводити деталі елемента календаря.

Наступні кроки коду:

  1. Завантажте файл як об’єкт MapiMessage за допомогою методу Load.
  2. Перевірте, чи завантажене повідомлення є типом календаря.
  3. Якщо це елемент календаря, перетворіть повідомлення на об’єкт MapiCalendar.
  4. Виведіть місцезнаходження, тему, дату початку та дату закінчення календарного елемента.

Створення календарного елемента

Щоб створити новий календарний елемент і зберегти його в різних форматах, використовуйте наступний приклад коду, наданий Aspose.Email:

  1. Створіть новий календарний елемент MapiCalendar з конкретними деталями, такими як місцезнаходження, тема, опис, час початку та час закінчення.
  2. Викличте метод Save на об’єкті календаря з параметрами, що вказують на ім’я вихідного файлу та параметри збереження. Календарний елемент зберігається як файл ICS (iCalendar) з розширенням “.ics” за допомогою MapiCalendarSaveOptions.DefaultIcs.
  3. Аналогічно, метод Save викликається знову на об’єкті календаря, щоб зберегти календарний елемент як файл MSG (повідомлення Outlook) з розширенням “.msg” за допомогою MapiCalendarSaveOptions.DefaultMsg.

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

Aspose.Email пропонує клас MapiContact, який використовується для роботи з елементами контактів Microsoft Outlook. Це дозволяє розробникам створювати, читати, оновлювати та маніпулювати контактами Outlook у різних форматах, таких як MSG та VCF. Цей клас надає властивості та методи для налаштування та отримання інформації про контакти, включаючи ім’я, адресу електронної пошти, телефонні номери, посаду, компанію та інші деталі контакту.

Приклади коду нижче демонструють, як використовувати клас MapiContact для створення та читання контактів.

Читання контактних елементів

Процес читання елемента контакту включає завантаження контактного повідомлення з файлу MAPI та відображення деталей контакту:

  1. Завантажте MapiMessage з файлу, використовуючи MapiMessage.Load.
  2. Перевірте, чи підтримуваний тип MapiMessage є контактом.
  3. Якщо це контакт, перетворіть MapiMessage на об’єкт MapiContact.
  4. Відобразіть ім’я, електронну пошту та деталі компанії контакту.

Створення контактного елемента

Давайте створимо новий контакт, використовуючи клас MapiContact, встановимо різні властивості, такі як ім’я, адреса електронної пошти та інформація про компанію, а потім збережемо деталі контакту у форматах VCARD та MSG.

Процес включає наступні кроки:

  1. Створіть новий об’єкт MapiContact і ініціалізуйте його властивості, включаючи ім’я, адресу електронної пошти та інформацію про компанію.
  2. Збережіть деталі контакту у форматі VCARD, використовуючи метод Save з параметром ContactSaveFormat.VCard.
  3. Збережіть деталі контакту у форматі MSG, використовуючи метод Save з параметром ContactSaveFormat.Msg.

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

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

Читання завдань

Щоб отримати доступ до завдань і маніпулювати ними, завантажте одне з файлу за допомогою MapiMessage.Load. За кілька рядків коду ви можете отримати важливі деталі завдання, такі як тема, статус та відсоток виконання.

  1. Завантажте завдання з файлу, використовуючи MapiMessage.Load.
  2. Перевірте, чи завантажене повідомлення є типом MapiItemType Task.
  3. Якщо повідомлення є завданням, перетворіть його на тип MapiTask.
  4. Відобразіть деталі завдання, надрукувавши тему, статус і відсоток виконання.

Створення завдання

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

  1. Створіть новий об’єкт завдання, використовуючи клас MapiTask з вказаними деталями, такими як заголовок, опис, дата початку, дата закінчення, відсоток виконання та статус.
  2. Встановіть властивість PercentComplete завдання та властивість Status.
  3. Збережіть створене завдання у файл MSG, використовуючи метод Save з параметром TaskSaveFormat.Msg як параметр формату.

Управління записами журналу

Запис журналу Outlook представлений класом MapiJournal. Наступні інструкції допоможуть вам створити та прочитати запис журналу.

Читання елемента MapiJournal

Щоб прочитати елемент MapiJournal, ви можете завантажити повідомлення журналу за допомогою методу MapiMessage.Load. Після підтвердження, що підтримуваний тип є журналом, ви можете отримати та відобразити деталі журналу, такі як його тема, статус документа, час початку та час закінчення.

  1. Завантажте повідомлення MAPI з файлу.
  2. Перевірте, чи підтримуваний тип завантаженого повідомлення є елементом журналу.
  3. Якщо повідомлення є типом журналу, перетворіть його на об’єкт MapiJournal.
  4. Виведіть деталі журналу, включаючи тему, статус, час початку та час закінчення.

Створення елемента MapiJournal

Тепер ми будемо створювати запис журналу та включати деталі. Запис також міститиме короткий опис зустрічі. Цей код демонструє, як створити та зберегти MapiJournal.

  1. Визначте новий запис журналу, використовуючи клас MapiJournal з конкретними деталями, такими як заголовок, опис, опис зустрічі та підсумок обговорення.
  2. Встановіть час початку та закінчення.
  3. Вкажіть компанію та категоризуйте запис.
  4. Збережіть створений запис журналу у файл за допомогою методу Save.

Управління нотатками

Aspose.Email пропонує клас MapiNote, що представляє нотатку Outlook. Це забезпечує рішення для створення та отримання інформації про нотатки ефективно. Давайте подивимося, як це працює.

Читання нотатки

Щоб отримати доступ до деталей нотатки та відобразити їх, завантажте повідомлення нотатки, використовуючи метод MapiMessage.Load, і отримайте об’єкт нотатки. Потім ви можете отримати та продемонструвати специфічні деталі, такі як тема, тіло та колір нотатки для подальшої обробки.

  1. Завантажте MapiMessage з файлу.
  2. Якщо завантажене повідомлення є типом нотатки, перетворіть MapiMessage на об’єкт MapiNote.
  3. Надрукуйте тему, тіло та колір перетвореного об’єкта MapiNote.

Створення нотатки

Створення нової нотатки легко досягти, визначивши властивості теми, тіла та кольору нотатки в новому об’єкті MapiNote. Після налаштування нотатки, її можна зберегти як файл повідомлення, використовуючи метод збереження з вказаним форматом файлу для подальшого використання та управління.

  1. Створіть новий об’єкт MapiNote з темою, тілом та кольором.
  2. Збережіть нотатку у файл MSG, викликавши метод Save.

Управління списками розсилки

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

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

Щоб прочитати елемент списку розсилки, почніть із завантаження його з файлу за допомогою методу MapiMessage.Load. Якщо завантажений елемент є типом DistList, ви можете відобразити його деталі, такі як ім’я та інформація про учасників.

  1. Завантажте список розсилки з файлу.
  2. Перевірте, чи завантажене повідомлення є типом списку розсилки (DistList).
  3. Перетворіть повідомлення на об’єкт MapiDistributionList.
  4. Відобразіть ім’я списку розсилки та учасників.

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

Для створення нового списку розсилки використовуйте простір імен Aspose.Email.Mapi. Додайте до нього учасників, вказуючи їхні імена та адреси електронної пошти. Ви можете зберегти список розсилки у форматі VCF або MSG для подальшого використання.

  1. Створіть новий список розсилки за допомогою класу MapiDistributionList.
  2. Додайте учасників до списку розсилки разом з їхніми адресами електронної пошти.
  3. Збережіть список розсилки у форматі VCF, використовуючи метод Save.
  4. Збережіть список розсилки у форматі MSG за допомогою того ж методу Save.

Висновок

У цій статті блогу ми дослідили способи читання та створення елементів Outlook, таких як календарі, контакти, завдання, записи журналу, нотатки та списки розсилки програмно на C#. Для програмування ми використовували Aspose.Email для .NET, всебічну бібліотеку, яка полегшує роботу з завданнями, пов’язаними з електронною поштою, включаючи маніпуляції з різними елементами Outlook. Використовуючи класи, надані бібліотекою, ви можете створювати, читати та маніпулювати цими елементами з легкістю. Ця стаття охоплює базові приклади кожного елемента, надаючи основу для більш складних операцій, які можуть знадобитися у ваших застосунках. Інтуїтивно зрозумілі приклади коду допоможуть вам оцінити можливості бібліотеки та зрозуміти, як реалізувати її функціональність у вашому проекті.

Не соромтеся використовувати наші публічні ресурси:

  • API reference пропонує детальну інформацію про класи та методи.
  • Documentation надає всебічні посібники з прикладами.
  • Support forum дозволяє користувачам шукати допомогу та обговорювати проблеми.
  • Blog містить оновлення, навчальні посібники та найкращі практики.

Дивіться також