Управление заметками Outlook в C#

Заметки Outlook предлагают пользователям удобный способ создания быстрых, доступных напоминаний в их почтовом ящике. Хранящиеся в файлах PST, эти напоминания управляются вместе с электронной почтой, контактами, событиями календаря и другими элементами Outlook. Для разработчиков, работающих с данными Microsoft Outlook программно, доступ к, создание или управление напоминаниями может быть важным для автоматизации рабочих процессов или создания приложений, повышающих продуктивность.

В этой статье мы рассмотрим, как работать с заметками Outlook в C# с использованием библиотеки .NET. Этот гид охватывает загрузку и доступ к напоминаниям внутри файлов PST, извлечение содержимого, создание новых и даже управление ими на сервере Exchange. Используя эти возможности, разработчики могут программно обрабатывать напоминания, облегчая интеграцию, резервное копирование или пользовательские решения управления.

Библиотека C# для работы с заметками Outlook

Чтобы создать и управлять заметками Outlook в C#, мы будем использовать библиотеку Aspose.Email для .NET, которая предоставляет мощные API для работы с различными функциями, связанными с электронной почтой и сообщениями, включая заметки. Эта библиотека поддерживает добавление, чтение, обновление и удаление их в файлах PST, что делает ее идеальной для работы с данными Outlook.

Установка

Вы можете установить Aspose.Email для .NET через диспетчер пакетов NuGet в Visual Studio или с помощью консоли диспетчера пакетов NuGet. Вот оба метода:

  • Используя диспетчер пакетов NuGet в Visual Studio:
  1. Откройте свой проект в Visual Studio.
  2. Перейдите в Инструменты > Диспетчер пакетов NuGet > Управление пакетами NuGet для решения.
  3. Найдите Aspose.Email на вкладке Обзор.
  4. Выберите пакет Aspose.Email и нажмите Установить.
  • Используя консоль диспетчера пакетов NuGet:
  1. Откройте Консоль диспетчера пакетов в Visual Studio, перейдя в Инструменты > Диспетчер пакетов NuGet > Консоль диспетчера пакетов.
  2. Выполните следующую команду для установки Aspose.Email для .NET:
Install-Package Aspose.Email

Кроме того, вы можете скачать последнюю версию API прямо с веб-сайта Aspose.

После установки библиотеки вы будете готовы начать работу с заметками Outlook в вашем проекте C#. API Aspose.Email упрощает взаимодействие с данными Outlook, обеспечивая эффективное управление ими в ваших .NET приложениях.

Создать новую заметку

Класс MapiNote в .NET позволяет вам создавать новые заметки с настраиваемыми свойствами, такими как цвет, тема и тело. После настройки заметка может быть сохранена как отдельный файл .msg для дальнейшего использования в Outlook или других совместимых приложениях.

Следующий пример демонстрирует создание новой заметки и сохранение ее в файл .msg:

  1. Создайте объект MapiNote и установите его свойства, включая Color, Subject и Body, чтобы определить внешний вид и содержимое заметки.
  2. Используйте метод Save, указав имя файла и формат (NoteSaveFormat.Msg), чтобы сохранить заметку как независимый файл .msg.
// Create a new MapiNote
var newNote = new MapiNote
{
Color = NoteColor.Yellow,
Subject = "Meeting Reminder",
Body = "Remember to review the quarterly report before the meeting."
};
// Save the note as an .msg file
newNote.Save("MeetingReminderNote.msg", NoteSaveFormat.Msg);
view raw CreateNewStickyNote.cs hosted with ❤ by GitHub

С помощью этого подхода вы можете легко создавать и распространять заметки как файлы .msg, предоставляя гибкий способ управления ими вне файла PST.

Добавить новую заметку в PST

Чтобы добавить новую заметку в файл PST, вы можете создать объект MapiNote и сохранить его в папке “Заметки” файла PST. Процесс включает загрузку файла PST, доступ к соответствующей папке, создание напоминания и его добавление в папку. Ниже приведено пошаговое руководство с кодом, демонстрирующим, как это сделать:

  1. Загрузите файл PST с помощью метода PersonalStorage.FromFile.
  2. Получите доступ к папке “Заметки” в файле PST.
  3. Создайте новый экземпляр класса MapiNote с необходимыми свойствами, такими как цвет, тема и тело.
  4. Используйте метод AddMapiMessageItem, чтобы добавить заметку в папку.
// Load the PST file
using (var pst = PersonalStorage.FromFile(pstFilePath));
// Access the Notes folder
var notesFolder = pst.RootFolder.GetSubFolder("Notes");
if (notesFolder != null)
{
// Create a new MapiNote
var newNote = new MapiNote
{
Color = NoteColor.Yellow, // Set the desired note color
Subject = "Meeting Reminder", // Set the subject
Body = "Don't forget the meeting at 10 AM." // Set the note body
};
// Add the sticky note to the Notes folder
notesFolder.AddMapiMessageItem(newNote);
}
view raw AddNewStickyNoteToPST.cs hosted with ❤ by GitHub

Извлечь заметки Outlook из файла PST

Чтобы извлечь заметки из файла PST, вам нужно получить доступ к папке Заметки и пройтись по ее содержимому. Следующий пример демонстрирует, как загрузить файл PST, получить доступ к целевой папке и извлечь заметки внутри нее:

  1. Загрузите указанный файл PST с помощью метода PersonalStorage.FromFile.
  2. Используйте GetSubFolder(“Notes”), чтобы получить папку Заметки из корневой папки файла PST.
  3. Вызовите метод EnumerateMapiMessages на папке и верните все сообщения MAPI. Код фильтрует эти сообщения, чтобы включить только объекты MapiNote.
  4. Отобразите каждую извлеченную заметку с ее темой, цветом, высотой, шириной и телом и распечатайте их в консоль.
// Load the PST file
using (var pst = PersonalStorage.FromFile("YourPSTFile.pst"));
// Access the Notes folder
var notesFolder = pst.RootFolder.GetSubFolder("Notes");
if (notesFolder != null)
{
// Iterate through items in the Notes folder
foreach (var note in notesFolder.EnumerateMapiMessages().OfType<MapiNote>())
{
// Process the sticky note details
Console.WriteLine("Note Subject: " + note.Subject);
Console.WriteLine("Note Color: " + note.Color);
Console.WriteLine("Note Height: " + note.Height);
Console.WriteLine("Note Width: " + note.Width);
Console.WriteLine("Note Body: " + note.Body);
Console.WriteLine();
}
}
view raw RetrieveStickyNotesFromPST.cs hosted with ❤ by GitHub

Как создать новую заметку Outlook на сервере Exchange

Чтобы создать новую заметку на сервере Exchange, вы можете использовать EWSClient для взаимодействия с почтовым ящиком сервера. Этот процесс включает установление соединения с сервером Exchange, создание нового объекта MapiNote и его сохранение в папке Заметки. Ниже приведено пошаговое руководство с кодом, демонстрирующим, как это сделать:

  1. Сначала вам нужно установить соединение с сервером Exchange, используя класс EWSClient. Это требует URL сервера и соответствующих учетных данных для аутентификации.
  2. Создайте новый экземпляр MapiNote и установите его свойства, такие как цвет, тема и тело.
  3. Используйте метод CreateItem класса EWSClient, чтобы сохранить новую заметку в указанной папке почтового ящика Exchange.

Вот пример кода, демонстрирующий, как создать и сохранить новую заметку на сервере Exchange:

// Replace these with your actual credentials and server information
string userName = "your_email@example.com";
string accessToken = "your_access_token"; // OAuth access token
// Create new note instance
var newNote = new MapiNote
{
Color = NoteColor.Yellow,
Subject = "Meeting Reminder",
Body = "Don't forget about the meeting tomorrow at 10 AM."
};
// Set up the EWS client
using var client = EWSClient.GetEWSClient("https://outlook.office365.com/EWS/Exchange.asmx",
new OAuthNetworkCredential(userName, accessToken));
// Create the note on the Exchange Server
client.CreateItem(client.MailboxInfo.NotesUri, newNote);
view raw CreateNoteOnExchange.cs hosted with ❤ by GitHub

Следуя этому процессу, вы можете создавать заметки прямо на сервере Exchange.

Получить заметки с сервера Exchange

Процесс включает в себя аутентификацию на сервере Exchange, перечисление доступных заметок и затем получение деталей каждой заметки. Вот как вы можете это сделать:

  1. Сначала вам нужно создать экземпляр EWSClient, используя ваши учетные данные сервера Exchange.
  2. Используйте метод ListMessages, чтобы получить список сообщений в папке Заметки.
  3. Для каждой заметки используйте метод FetchMapiNotes, чтобы получить ее детали.

Вот пример кода, иллюстрирующий эти шаги:

// Define the credentials and EWS endpoint
string userName = "your-email@example.com";
string accessToken = "your-access-token";
// Create an instance of the EWS client
using var client = EWSClient.GetEWSClient("https://outlook.office365.com/EWS/Exchange.asmx", new OAuthNetworkCredential(userName, accessToken));
// List all notes in the Notes folder
var messageInfos = client.ListMessages(client.MailboxInfo.NotesUri);
// Fetch the MAPI notes using the unique URIs of the listed messages
var notes = client.FetchMapiNotes(messageInfos.Select(info => info.UniqueUri));
// Process and display each fetched note
foreach (var note in notes)
{
Console.WriteLine("Note Subject: " + note.Subject);
Console.WriteLine("Note Color: " + note.Color);
Console.WriteLine("Note Body: " + note.Body);
}
view raw FetchNotesFromExchange.cs hosted with ❤ by GitHub

Замените your-email@example.com и your-access-token на ваш фактический адрес электронной почты Exchange и токен доступа OAuth.

Этот подход позволяет вам эффективно управлять и получать доступ к заметкам, хранящимся на сервере Exchange.

Заключение

Управление заметками Outlook с использованием C# .NET предоставляет подход к организации и извлечению важной информации на рабочем месте. Используя возможности протокола MAPI, разработчики могут создавать, читать и обновлять заметки, хранящиеся как локально в файлах PST, так и на сервере Exchange.

С помощью описанных методов пользователи могут повысить продуктивность, программно управляя своими данными, что позволяет лучше интегрироваться с другими приложениями и рабочими процессами. Будь то создание новых заметок для быстрых напоминаний или извлечение существующих для справки, предоставленные инструменты способствуют эффективному управлению информацией.

Бесплатные ресурсы

Помимо своего прогрессивного C# API для электронной почты, библиотека также предоставляет ряд бесплатных ресурсов:

Оцените Aspose.Email

Вы можете попробовать все функции Aspose.Email бесплатно с помощью его версии для оценки.

Получить временную лицензию

Если вы хотите протестировать Aspose.Email без ограничений версии для оценки, вы также можете запросить 30-дневную временную лицензию. Бесплатная пробная версия даст вам хорошее представление о возможностях сервиса и позволит вам начать раннюю разработку.

Смотрите также