Exchange 中的 EWS 的电子邮件属性和元素
了解在 Exchange 中使用 EWS 托管 API 或 EWS 可对电子邮件获取的第一类和其他属性和元素。
电子邮件的属性超过50个，如果需要，您可以在不知道要查找的位置的情况下获取所需的属性。 有关使用电子邮件属性和元素的最重要的一点是，它们包含在一组第一类属性以及每个主要检索方法和操作返回的元素中。 返回的一组第一类属性根据您使用的检索方法的不同而不同。 此外，不能 fooled AllProperties 值的BaseShape ews 元素，这一点与 EWS 托管 API 中的BasePropertySet枚举值相对应。 此值实际上并不包含所有属性，它只包括第一类属性。
电子邮件的第一类属性和元素
由 ews 托管 API EmailMessage方法和 ews GetItem操作返回的一组第一类属性和元素与由 Ews 托管 api ExchangeService FindItems方法和 ews FindItem操作返回的一组第一类属性和元素稍有不同。 由FindItems方法和FindItem操作返回的第一个类属性是由Bind方法和GetItem操作返回的属性的子集。 表1列出了Bind方法和GetItem操作返回的所有第一类属性，并指定FindItems方法或FindItem操作不会返回这些属性中的哪一个。 请注意，不能扩展FindItems方法或FindItem操作以检索其他属性和元素，如ToRecipients、 CcRecipients和BccRecipients。 如果需要检索这些值，请使用FindItems方法或FindItem操作获取电子邮件的项目 Id，然后使用Bind方法或GetItem操作检索所需的属性。 有关演示如何使用Bind或FindItems方法检索项目的代码示例，请参阅使用 EWS 托管 API 获取项目。 有关演示如何使用GetItem或FindItem操作检索项目的代码示例，请参阅使用 EWS 获取项目。
下表按其在响应中出现的顺序列出了第一类属性和元素。
表1。第一类电子邮件属性和元素
电子邮件的其他属性和元素
并非所有重要的电子邮件属性和元素都是第一类的属性和元素。 若要获取其他属性或元素，需要将它们添加到PropertySet中（如果使用的是 EWS 托管 API），或者使用属性路径将它们添加到 ews 操作调用中。 例如，若要检索邮件的文本正文和 MIME 内容，请创建您的PropertySet ，如Bind或Load方法所示。
PropertySet(BasePropertySet.IdOnly, ItemSchema.TextBody, ItemSchema.MimeContent);
或者，如果您正在使用 EWS，请将元素添加到GetItem操作请求中的AdditionalProperties元素中，如下所示。
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:TextBody" />
<t:FieldURI FieldURI="item:MimeContent" />
</t:AdditionalProperties>
继承自 EWS 托管 API ServiceObject对象的EmailMessage属性不能包含在Bind方法的属性集中;但是，所有ServiceObject属性在EmailMessage对象中都是可读的，并由Bind方法检索。
表2。其他电子邮件属性和元素
| EWS 托管 API 属性 | EWS 元素 | 读写或只读 |
|---|---|---|
| ArchiveTag |
ArchiveTag |
读写 |
| ExtendedProperties |
ExtendedProperty |
只读 |
| IconIndex |
IconIndex |
只读 |
| IsAttachment |
不可用 |
只读 |
| IsDirty |
不可用 |
只读 |
| IsNew |
不可用 |
只读 |
| Item |
Item |
只读 |
| MimeContent |
MimeContent |
只读 |
| 不可用 |
MimeContentUTF8 |
只读 |
| NormalizedBody |
NormalizedBody |
只读 |
| PolicyTag |
PolicyTag |
读写 |
| 预览 |
预览 |
读写 |
| RetentionDate |
RetentionDate |
只读 |
| 架构 |
不可用 |
只读 |
| 服务 |
不可用 |
只读 |
| StoreEntryId |
StoreEntryId |
只读 |
| TextBody |
TextBody |
只读 |
| UniqueBody |
UniqueBody |
只读 |