Email свойства и элементы в EWS в Exchange
Узнайте о первоклассных и других свойствах и элементах, которые можно получить в сообщениях электронной почты с помощью управляемого API EWS или EWS в Exchange.
Email сообщения имеют более 50 свойств, и получение нужных, если вы не знаете, где искать, может сбить с толку. Самое важное, что нужно знать о работе со свойствами и элементами электронной почты, которые включаются в набор первоклассных свойств и элементов, возвращаемых каждым из основных методов и операций извлечения. Набор возвращаемых свойств первого класса зависит от используемого метода извлечения. Также важно не обманываться значением AllProperties элемента BaseShape EWS, которое соответствует значению перечисления BasePropertySet.FirstClassMessageProperties в управляемом API EWS. Это значение фактически не включает все свойства, оно включает только свойства первого класса.
Первоклассные свойства и элементы для сообщений электронной почты
Набор первоклассных свойств и элементов, возвращаемых методом EmailMessage.Bind управляемого API EWS и операцией GetItem EWS, немного отличается от набора свойств и элементов первого класса, возвращаемых методом ExchangeService.FindItems управляемого API EWS и операцией EWS FindItem . Свойства первого класса, возвращаемые методом FindItems и операцией FindItem , являются подмножеством свойств, возвращаемых методом Bind и операцией GetItem . В таблице 1 перечислены все свойства первого класса, возвращаемые методом Bind и операцией GetItem , а также указано, какие из них не возвращаются методом FindItems или операцией FindItem . Обратите внимание, что нельзя расширить метод FindItems или операцию FindItem для получения дополнительных свойств и элементов, таких как ToRecipients, CcRecipients и BccRecipients. Если вам нужно получить эти значения, используйте метод FindItems или операцию FindItem , чтобы получить идентификаторы элементов электронной почты, а затем используйте метод Bind или операцию GetItem , чтобы получить необходимые свойства. Примеры кода, показывающие, как получить элементы с помощью метода Bind или FindItems , см. в разделе Получение элемента с помощью управляемого API EWS. Примеры кода, показывающие, как извлекать элементы с помощью операций GetItem или FindItem , см. в разделе Получение элемента с помощью EWS.
Свойства и элементы первого класса перечислены в следующей таблице в том порядке, в котором они отображаются в ответе.
Таблица 1. Первоклассные свойства и элементы электронной почты
Другие свойства и элементы для сообщений электронной почты
Не все важные свойства и элементы электронной почты являются первоклассными свойствами и элементами. Чтобы получить другие свойства или элементы, необходимо добавить их в PropertySet , если вы используете управляемый API EWS, или использовать путь к свойству, чтобы добавить их в вызов операции EWS. Например, чтобы получить текст текста и содержимое MIME сообщения, создайте propertySet , как показано для метода Bind или Load .
PropertySet(BasePropertySet.IdOnly, ItemSchema.TextBody, ItemSchema.MimeContent);
Или, если вы используете EWS, добавьте элементы в элемент AdditionalProperties в запросе на операцию GetItem , как показано ниже.
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:TextBody" />
<t:FieldURI FieldURI="item:MimeContent" />
</t:AdditionalProperties>
Свойства EmailMessage, унаследованные от объекта EWS Managed API ServiceObject, не могут быть включены в набор свойств для метода Bind; однако все свойства ServiceObject доступны для чтения в объекте EmailMessage и извлекаются методом Bind.
Табл. 2. Другие свойства и элементы электронной почты
| Свойство Управляемого API EWS | Элемент EWS | Только для чтения и записи |
|---|---|---|
| ArchiveTag |
ArchiveTag |
Чтение и запись |
| ExtendedProperties |
ExtendedProperty |
Только для чтения |
| IconIndex |
IconIndex |
Только для чтения |
| IsAttachment |
Недоступно |
Только для чтения |
| Isdirty |
Недоступно |
Только для чтения |
| IsNew |
Недоступно |
Только для чтения |
| Элемент |
Элемент |
Только для чтения |
| MimeContent |
MimeContent |
Только для чтения |
| Недоступно |
MimeContentUTF8 |
Только для чтения |
| NormalizedBody |
NormalizedBody |
Только для чтения |
| PolicyTag |
PolicyTag |
Чтение и запись |
| Предварительный просмотр |
Предварительный просмотр |
Чтение и запись |
| RetentionDate |
RetentionDate |
Только для чтения |
| схема; |
Недоступно |
Только для чтения |
| Служба |
Недоступно |
Только для чтения |
| StoreEntryId |
StoreEntryId |
Только для чтения |
| TextBody |
TextBody |
Только для чтения |
| UniqueBody |
UniqueBody |
Только для чтения |