Propriedades e elementos de email no EWS no ExchangeEmail properties and elements in EWS in Exchange

Saiba mais sobre a primeira classe e outras propriedades e elementos que você pode obter nas mensagens de email usando a API gerenciada do EWS ou o EWS no Exchange.Learn about the first-class and other properties and elements that you can get on email messages by using the EWS Managed API or EWS in Exchange.

As mensagens de email têm mais de 50 Propriedades e obtendo as que você deseja, quando você quiser, podem ser confusas se você não souber onde procurar.Email messages have more than 50 properties, and getting the ones you want, when you want them, can be confusing if you don't know where to look. O mais importante a saber mais sobre como trabalhar com propriedades e elementos de email é incluído no conjunto de propriedades e elementos de primeira classe que é retornado por cada um dos principais métodos e operações de recuperação.The most important thing to know about working with email properties and elements is which are included in the set of first-class properties and elements that is returned by each of the main retrieval methods and operations. O conjunto de propriedades de primeira classe que é retornado varia com base no método de recuperação que você usa.The set of first-class properties that is returned varies based on the retrieval method that you use. Também é importante não ser enganado pelo valor de do elemento BaseShape EWS, que corresponde ao valor de enumeração BasePropertySet. FirstClassMessageProperties na API gerenciada do EWS.It's also important not to be fooled by the AllProperties value of the BaseShape EWS element, which corresponds to the BasePropertySet.FirstClassMessageProperties enumeration value in the EWS Managed API. Esse valor não inclui, de fato, todas as propriedades, apenas inclui as propriedades de primeira classe.This value doesn't actually include all properties, it only includes the first-class properties.

Propriedades e elementos de primeira classe para mensagens de emailFirst-class properties and elements for email messages

O conjunto de propriedades e elementos de primeira classe que são retornados pelo método de API gerenciada do EWS EmailMessage. bind e a operação do EWS GetItem é um pouco diferente do conjunto de propriedades e elementos de primeira classe que é retornado pelo método ExchangeService. FindItems da API gerenciada do EWS e pela operação do EWS FindItem .The set of first-class properties and elements that are returned by the EWS Managed API EmailMessage.Bind method and the EWS GetItem operation is slightly different than the set of first-class properties and elements that is returned by the EWS Managed API ExchangeService.FindItems method and the EWS FindItem operation. As propriedades de primeira classe retornadas pelo método FindItems e a operação FindItem são um subconjunto das propriedades retornadas pelo método BIND e a operação GetItem .The first-class properties returned by the FindItems method and FindItem operation are a subset of the properties returned by the Bind method and GetItem operation. A tabela 1 lista todas as propriedades de primeira classe retornadas pelo método BIND e a operação GetItem e especifica quais delas não são retornadas pelo método FindItems ou pela operação FindItem .Table 1 lists all the first-class properties returned by the Bind method and the GetItem operation, and specifies which of those are not returned by the FindItems method or FindItem operation. Observe que você não pode estender o método FindItems ou a operação FindItem para recuperar propriedades e elementos adicionais, como ToRecipients, CcRecipientse BccRecipients.Note that you cannot extend the FindItems method or the FindItem operation to retrieve additional properties and elements such as ToRecipients, CcRecipients, and 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, em seguida, use o método BIND ou a operação GetItem para recuperar as propriedades necessárias.If you need to retrieve those values, use the FindItems method or the FindItem operation to get the item IDs of the emails, and then use the Bind method or the GetItem operation, to retrieve the required properties. 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.For code examples that show how to retrieve items by using the Bind or the FindItems method, see Get an item by using the EWS Managed API. 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.For code examples that show how to retrieve items by using the GetItem or FindItem operations, see Get an item by using EWS.

As propriedades e elementos da primeira classe estão listados na tabela a seguir na ordem em que aparecem em uma resposta.The first-class properties and elements are listed in the following table in the order in which they appear in a response.

Tabela 1. Elementos e propriedades de email de primeira classeTable 1. First-class email properties and elements

Propriedade da API gerenciada do EWSEWS Managed API property Elemento do EWSEWS element Propriedade First-Class para o método FindItems ou a operação FindItem ?First-class property for the FindItems method or the FindItem operation? Leitura-gravação ou somente leituraRead-write or read-only
IdId
ItemIdItemId
SimYes
Somente leituraRead-only
ParentFolderIdParentFolderId
ParentFolderIdParentFolderId
SimYes
Somente leituraRead-only
ItemClassItemClass
ItemClassItemClass
SimYes
Leitura-gravaçãoRead-write
AssuntoSubject
AssuntoSubject
SimYes
Leitura-gravaçãoRead-write
SensitivitySensitivity
SensitivitySensitivity
SimYes
Somente leituraRead-only
BodyBody
BodyBody
NãoNo
Leitura-gravaçãoRead-write
AnexosAttachments
AnexosAttachments
NãoNo
Leitura-gravaçãoRead-write
DateTimeReceivedDateTimeReceived
DateTimeReceivedDateTimeReceived
SimYes
Somente leituraRead-only
TamanhoSize
TamanhoSize
SimYes
Somente leituraRead-only
CategoriasCategories
CategoriasCategories
NãoNo
Leitura-gravaçãoRead-write
ImportanceImportance
ImportanceImportance
SimYes
Leitura-gravaçãoRead-write
InrespondertoInReplyTo
InrespondertoInReplyTo
SimYes
Leitura-gravaçãoRead-write
IsenviadoIsSubmitted
IsenviadoIsSubmitted
SimYes
Somente leituraRead-only
IsDraftIsDraft
IsDraftIsDraft
SimYes
Somente leituraRead-only
IsFromMeIsFromMe
IsFromMeIsFromMe
SimYes
Somente leituraRead-only
IsResendIsResend
IsResendIsResend
SimYes
Somente leituraRead-only
IsUnmodifiedIsUnmodified
IsUnmodifiedIsUnmodified
SimYes
Somente leituraRead-only
PropriedadeinternetmessageheadersInternetMessageHeaders
PropriedadeinternetmessageheadersInternetMessageHeaders
NãoNo
Somente leituraRead-only
DateTimeSentDateTimeSent
DateTimeSentDateTimeSent
SimYes
Somente leituraRead-only
DateTimeCreatedDateTimeCreated
DateTimeCreatedDateTimeCreated
SimYes
Somente leituraRead-only
AllowedResponseActionsAllowedResponseActions
ResponseObjectsResponseObjects
NãoNo
Somente leituraRead-only
ReminderDueByReminderDueBy
ReminderDueByReminderDueBy
SimYes
Leitura-gravaçãoRead-write
ReminderSetIsReminderSet
ReminderIsSetReminderIsSet
SimYes
Leitura-gravaçãoRead-write
ReminderMinutesBeforeStartReminderMinutesBeforeStart
ReminderMinutesBeforeStartReminderMinutesBeforeStart
SimYes
Leitura-gravaçãoRead-write
DisplayCcDisplayCc
DisplayCcDisplayCc
SimYes
Somente leituraRead-only
DisplayToDisplayTo
DisplayToDisplayTo
SimYes
Somente leituraRead-only
HasAttachmentsHasAttachments
HasAttachmentsHasAttachments
SimYes
Somente leituraRead-only
CulturaCulture
CulturaCulture
SimYes
Leitura-gravaçãoRead-write
EffectiveRightsEffectiveRights
EffectiveRightsEffectiveRights
SimYes
Somente leituraRead-only
LastModifiedLastModifiedName
LastModifiedLastModifiedName
SimYes
Somente leituraRead-only
LastModifiedTimeLastModifiedTime
LastModifiedTimeLastModifiedTime
SimYes
Somente leituraRead-only
IsassociatedIsAssociated
IsassociatedIsAssociated
SimYes
Leitura-gravaçãoRead-write
WebClientReadFormQueryStringWebClientReadFormQueryString
WebClientReadFormQueryStringWebClientReadFormQueryString
SimYes
Somente leituraRead-only
WebClientEditFormQueryStringWebClientEditFormQueryString
WebClientEditFormQueryStringWebClientEditFormQueryString
SimYes
Somente leituraRead-only
ConversationIdConversationId
ConversationIdConversationId
SimYes
Somente leituraRead-only
FlagFlag
FlagFlag
SimYes
Leitura-gravaçãoRead-write
InstanceKeyInstanceKey
InstanceKeyInstanceKey
SimYes
Somente leituraRead-only
EntityExtractionResultEntityExtractionResult
EntityExtractionResultEntityExtractionResult
NãoNo
Somente leituraRead-only
SenderSender
SenderSender
SimYes
Leitura-gravaçãoRead-write
ToRecipientsToRecipients
ToRecipientsToRecipients
NãoNo
Somente leituraRead-only
CcRecipientsCcRecipients
CcRecipientsCcRecipients
NãoNo
Somente leituraRead-only
BccRecipientsBccRecipients
BccRecipientsBccRecipients
NãoNo
Somente leituraRead-only
IsReadReceiptRequestedIsReadReceiptRequested
IsReadReceiptRequestedIsReadReceiptRequested
SimYes
Leitura-gravaçãoRead-write
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
SimYes
Leitura-gravaçãoRead-write
ConversationIndexConversationIndex
ConversationIndexConversationIndex
SimYes
Somente leituraRead-only
ConversationTopicConversationTopic
ConversationTopicConversationTopic
SimYes
Somente leituraRead-only
DeFrom
DeFrom
SimYes
Leitura-gravaçãoRead-write
InternetMessageIdInternetMessageId
InternetMessageIdInternetMessageId
SimYes
Somente leituraRead-only
IsReadIsRead
IsReadIsRead
SimYes
Leitura-gravaçãoRead-write
IsResponseRequestedIsResponseRequested
IsResponseRequestedIsResponseRequested
SimYes
Leitura-gravaçãoRead-write
ReplyToReplyTo
ReplyToReplyTo
NãoNo
Somente leituraRead-only
ReferencesReferences
ReferencesReferences
SimYes
Leitura-gravaçãoRead-write
ReceivedByReceivedBy
ReceivedByReceivedBy
SimYes
Somente leituraRead-only
ReceivedRepresentingReceivedRepresenting
ReceivedRepresentingReceivedRepresenting
SimYes
Somente leituraRead-only

Outras propriedades e elementos para mensagens de emailOther properties and elements for email messages

Nem todas as propriedades e elementos de email importantes são propriedades e elementos da primeira classe.Not all important email properties and elements are first-class properties and elements. Para obter as outras propriedades ou elementos, você precisa adicioná-los ao seu PropertySet se estiver usando a API gerenciada do EWS ou usar um caminho de propriedade para adicioná-los à chamada de operação do EWS.To get the other properties or elements, you need to add them to your PropertySet if you're using the EWS Managed API, or use a property path to add them to your EWS operation call. 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 .For example, to retrieve the text body and the MIME content of a message, create your PropertySet as shown for the Bind or Load method.

PropertySet(BasePropertySet.IdOnly, ItemSchema.TextBody, ItemSchema.MimeContent);

Ou se você estiver usando o EWS, adicione os elementos ao elementoproperties na sua solicitação de operação do GetItem , como mostrado.Or if you're using EWS, add the elements to the AdditionalProperties element in your GetItem operation request, as shown.

<t:AdditionalProperties>
    <t:FieldURI FieldURI="item:TextBody" />
    <t:FieldURI FieldURI="item:MimeContent" />
</t:AdditionalProperties>

As propriedades EmailMessage herdadas do objeto do EWS Managed API ServiceObject 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 .EmailMessage properties inherited from the EWS Managed API ServiceObject object cannot be included in a property set for the Bind method; however, all the ServiceObject properties are readable on the EmailMessage object and are retrieved by the Bind method.

Tabela 2. Outras propriedades e elementos de emailTable 2. Other email properties and elements

Propriedade da API gerenciada do EWSEWS Managed API property Elemento do EWSEWS element Leitura-gravação ou somente leituraRead-write or read-only
ArchiveTagArchiveTag
ArchiveTagArchiveTag
Leitura-gravaçãoRead-write
ExtendedPropertiesExtendedProperties
ExtendedPropertyExtendedProperty
Somente leituraRead-only
IconIndexIconIndex
IconIndexIconIndex
Somente leituraRead-only
IsattachmentIsAttachment
Não disponívelNot available
Somente leituraRead-only
IsDirtyIsDirty
Não disponívelNot available
Somente leituraRead-only
IsNewIsNew
Não disponívelNot available
Somente leituraRead-only
ItemItem
ItemItem
Somente leituraRead-only
MimeContentMimeContent
MimeContentMimeContent
Somente leituraRead-only
Não disponívelNot available
MimeContentUTF8MimeContentUTF8
Somente leituraRead-only
NormalizedBodyNormalizedBody
NormalizedBodyNormalizedBody
Somente leituraRead-only
PolicyTagPolicyTag
PolicyTagPolicyTag
Leitura-gravaçãoRead-write
VisualizaçãoPreview
VisualizaçãoPreview
Leitura-gravaçãoRead-write
RetentionDateRetentionDate
RetentionDateRetentionDate
Somente leituraRead-only
EsquemaSchema
Não disponívelNot available
Somente leituraRead-only
ServiçoService
Não disponívelNot available
Somente leituraRead-only
StoreEntryIdStoreEntryId
StoreEntryIdStoreEntryId
Somente leituraRead-only
TextBodyTextBody
TextBodyTextBody
Somente leituraRead-only
UniqueBodyUniqueBody
UniqueBodyUniqueBody
Somente leituraRead-only

Confira tambémSee also