Email propriedades e elementos no EWS no Exchange
Saiba mais sobre as propriedades e outros elementos de primeira classe que você pode obter em mensagens de email usando a API Gerenciada do EWS ou o EWS no Exchange.
Email mensagens têm mais de 50 propriedades, e obter as que você deseja, quando quiser, pode ser confusa se você não sabe onde procurar. A coisa mais importante a saber sobre como trabalhar com propriedades e elementos de email é que estão incluídos no conjunto de propriedades de primeira classe e elementos que são retornados por cada um dos principais métodos e operações de recuperação. O conjunto de propriedades de primeira classe retornadas varia de acordo com o método de recuperação que você usa. Também é importante não ser enganado pelo valor AllProperties do elemento BaseShape EWS, que corresponde ao valor de enumeração BasePropertySet.FirstClassMessageProperties na API Gerenciada do EWS. Esse valor não inclui todas as propriedades, inclui apenas as propriedades de primeira classe.
Propriedades e elementos de primeira classe para mensagens de email
O conjunto de propriedades e elementos de primeira classe retornados pelo método EmailMessage.Bind da API Gerenciada do EWS e pela operação GetItem do EWS é ligeiramente diferente do conjunto de propriedades e elementos de primeira classe retornados pelo método ExchangeService.FindItems da API Gerenciada do EWS e pela operação EWS FindItem . As propriedades de primeira classe retornadas pelo método FindItems e pela operação FindItem são um subconjunto das propriedades retornadas pelo método Bind e pela operação GetItem . A Tabela 1 lista todas as propriedades de primeira classe retornadas pelo método Bind e pela operação GetItem e especifica quais delas não são retornadas pelo método FindItems ou pela operação FindItem . Observe que você não pode estender o método FindItems ou a operação FindItem para recuperar propriedades e elementos adicionais, como ToRecipients, CcRecipients e BccRecipients. Se você precisar recuperar esses valores, use o método FindItems ou a operação FindItem para obter as IDs de item dos emails e use o método Bind ou a operação GetItem para recuperar as propriedades necessárias. Para obter exemplos de código que mostram como recuperar itens usando o método Bind ou FindItems , consulte Obter um item usando a API Gerenciada do EWS. Para obter exemplos de código que mostram como recuperar itens usando as operações GetItem ou FindItem , consulte Obter um item usando o EWS.
As propriedades e elementos de primeira classe são listados na tabela a seguir na ordem em que aparecem em uma resposta.
Tabela 1. Propriedades e elementos de email de primeira classe
Outras propriedades e elementos para mensagens de email
Nem todas as propriedades e elementos de email importantes são propriedades e elementos de primeira classe. Para obter as outras propriedades ou elementos, você precisa adicioná-las ao PropertySet se estiver usando a API Gerenciada do EWS ou usar um caminho de propriedade para adicioná-las à sua chamada de operação do EWS. Por exemplo, para recuperar o corpo do texto e o conteúdo MIME de uma mensagem, crie seu PropertySet conforme mostrado para o método Bind ou Load .
PropertySet(BasePropertySet.IdOnly, ItemSchema.TextBody, ItemSchema.MimeContent);
Ou se você estiver usando o EWS, adicione os elementos ao elemento AdditionalProperties em sua solicitação de operação GetItem , conforme mostrado.
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:TextBody" />
<t:FieldURI FieldURI="item:MimeContent" />
</t:AdditionalProperties>
As propriedades emailMessage herdadas do objeto ServiceObject da API Gerenciada do EWS não podem ser incluídas em um conjunto de propriedades para o método Bind ; no entanto, todas as propriedades ServiceObject são legíveis no objeto EmailMessage e são recuperadas pelo método Bind .
Tabela 2. Outras propriedades e elementos de email
| Propriedade API Gerenciada do EWS | Elemento EWS | Leitura-gravação ou somente leitura |
|---|---|---|
| ArchiveTag |
ArchiveTag |
Leitura-gravação |
| ExtendedProperties |
ExtendedProperty |
Somente leitura |
| IconIndex |
IconIndex |
Somente leitura |
| IsAttachment |
Não disponível |
Somente leitura |
| Isdirty |
Não disponível |
Somente leitura |
| IsNew |
Não disponível |
Somente leitura |
| Item |
Item |
Somente leitura |
| MimeContent |
MimeContent |
Somente leitura |
| Não disponível |
MimeContentUTF8 |
Somente leitura |
| NormalizedBody |
NormalizedBody |
Somente leitura |
| PolicyTag |
PolicyTag |
Leitura-gravação |
| Visualização |
Visualização |
Leitura-gravação |
| RetentionDate |
RetentionDate |
Somente leitura |
| Esquema |
Não disponível |
Somente leitura |
| Serviço |
Não disponível |
Somente leitura |
| StoreEntryId |
StoreEntryId |
Somente leitura |
| TextBody |
TextBody |
Somente leitura |
| UniqueBody |
UniqueBody |
Somente leitura |