Получение, управление и обновление контактов в Exchange Server с помощью EWS

Учетные записи Exchange Server содержат больше, чем просто электронные сообщения. Кроме того, получение, перемещение, отправка и удаление электронных сообщений С серверов Exchange Aspose.Email позволяет работать с контактами. Эта статья объясняет, как получать информацию о контактах с помощью Exchange Web Services. Также в статье показано, как перечислять контакты из папки Contacts или разрешать контакты по имени.

Получить контакты с помощью EWS

Aspose.Email предоставляет EWSClient класс для подключения к Microsoft Exchange Server с использованием Exchange Web Services. Последующие фрагменты кода используют Exchange Web Services для чтения всех контактов. Следующий фрагмент кода показывает, как получить контакты с помощью EWS.

Разрешить контакты по имени

Следующий фрагмент кода показывает, как получать контакты с помощью EWS

Определить формат заметок контакта

Aspose.Email.Mail.Contact.NotesFormat указывает тип формата текста заметок контактов, определённый перечислением Aspose.Email.TextFormat.

Получить контакты по ID

Определенный контакт может быть получен с сервера по его ID, как показано в следующем примере кода.

Добавление контактов

Этот EWSClient класс CreateContact() метод может использоваться для добавления информации о контакте на сервер Exchange. CreateContact() метод принимает объект Contact в качестве входного параметра.

Для добавления контактов на сервер Exchange:

1. Инициализировать EWSClient с указанием адреса и учетных данных.
2. Инициализировать объект Contact с требуемыми свойствами.
3. Вызовите метод CreateContact, чтобы добавить контакт на сервер Exchange.

Aspose.Email предоставляет EWSClient класс для подключения к Microsoft Exchange Server с использованием Exchange Web Services. Фрагменты кода показывают, как использовать Exchange Web Services для добавления контактов на сервер Exchange.

Обновление контактов

Информацию о контакте можно обновлять с помощью Microsoft Outlook. Aspose.Email также может обновлять информацию о контакте на сервере Exchange с использованием Exchange Web Service (EWS). IEWSClient UpdateContact метод может обновлять информацию о контакте на сервере Exchange.

Удаление контактов

Этот EWSClient класс позволяет DeleteContact получать доступ и удалять контакты из папки контактов сервера Exchange. Этот метод принимает ID контакта или MapiContact в качестве входного параметра.

Для удаления контактов с сервера Exchange:

1. Инициализировать ExchangeWebServiceClient с указанием адреса и учетных данных.
2. Удалить контакт по его ID.
3. Удалить контакт, вызвав DeleteContact метод с MapiContact в качестве входного параметра.

Следующие фрагменты кода показывают, как удалять контакты с сервера Exchange с помощью Exchange Web Service.

Работа с расширенными свойствами контакта

 IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

//The required extended properties must be added in order to create or read them from the Exchange Server

string[] extraFields = new string[] {{ "User Field 1", "User Field 2", "User Field 3", "User Field 4" }};

foreach (string extraField in extraFields)

    client.ContactExtendedPropertiesDefinition.Add(extraField);

//Create a test contact on the Exchange Server

Contact contact = new Contact();

contact.DisplayName = "EMAILNET-38433 - " + Guid.NewGuid().ToString();

foreach (string extraField in extraFields)

    contact.ExtendedProperties.Add(extraField, extraField);

string contactId = client.CreateContact(contact);

//retrieve the contact back from the server after some time

Thread.Sleep(5000);

contact = client.GetContact(contactId);

//Parse the extended properties of contact

foreach (string extraField in extraFields)

    if (contact.ExtendedProperties.ContainsKey(extraField))

        Console.WriteLine(contact.ExtendedProperties[extraField].ToString());