Propriétés et éléments de messagerie dans EWS dans ExchangeEmail properties and elements in EWS in Exchange

Découvrez la première classe et les autres propriétés et éléments que vous pouvez obtenir sur les messages électroniques à l’aide de l’API managée EWS ou d’EWS dans 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.

Les messages électroniques comportent plus de 50 propriétés et obtiennent ceux que vous souhaitez, quand vous le souhaitez, peuvent être confus si vous ne les identifiez pas.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. La chose la plus importante à savoir sur l’utilisation des propriétés et des éléments de messagerie est incluse dans l’ensemble des propriétés et des éléments de première classe renvoyés par chacune des méthodes et opérations de récupération principales.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. L’ensemble des propriétés de première classe renvoyées varie en fonction de la méthode de récupération utilisée.The set of first-class properties that is returned varies based on the retrieval method that you use. Il est également important de ne pas tromper la valeur AllProperties de l’élément BaseShape EWS, qui correspond à la valeur d’énumération BasePropertySet. FIRSTCLASSMESSAGEPROPERTIES dans l’API managée 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. Cette valeur n’inclut pas réellement toutes les propriétés, elle inclut uniquement les propriétés de première classe.This value doesn't actually include all properties, it only includes the first-class properties.

Propriétés et éléments de première classe pour les messages électroniquesFirst-class properties and elements for email messages

L’ensemble des propriétés et des éléments de première classe qui sont renvoyés par la méthode EmailMessage. bind de l’API managée EWS et l’opération EWS GetItem est légèrement différent de l’ensemble des propriétés et des éléments de première classe renvoyés par la méthode EXCHANGESERVICE. FindItems de l’API managée EWS et l’opération 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. Les propriétés de première classe retournées par la méthode FindItems et l’opération FindItem sont un sous-ensemble des propriétés retournées par la méthode Bind et l’opération 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. Le tableau 1 répertorie toutes les propriétés de première classe retournées par la méthode Bind et l’opération GetItem , et spécifie celles qui ne sont pas renvoyées par la méthode FindItems ou l’opération 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. Notez que vous ne pouvez pas étendre la méthode FindItems ou l’opération FindItem pour récupérer des propriétés et des éléments supplémentaires, tels que ToRecipients, CCRecipientset 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. Si vous avez besoin de récupérer ces valeurs, utilisez la méthode FindItems ou l’opération FindItem pour obtenir les ID d’élément des courriers électroniques, puis utilisez la méthode Bind ou l’opération GetItem pour récupérer les propriétés requises.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. Pour obtenir des exemples de code qui montrent comment récupérer des éléments à l’aide de la méthode Bind ou FindItems , consultez la rubrique obtenir un élément à l’aide de l’API managée 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. Pour obtenir des exemples de code qui montrent comment récupérer des éléments à l’aide des opérations GetItem ou FindItem , reportez-vous à la rubrique obtenir un élément à l’aide d’EWS.For code examples that show how to retrieve items by using the GetItem or FindItem operations, see Get an item by using EWS.

Les propriétés et les éléments de première classe sont répertoriés dans le tableau suivant, dans l’ordre dans lequel ils apparaissent dans une réponse.The first-class properties and elements are listed in the following table in the order in which they appear in a response.

Tableau 1. Éléments et propriétés de messagerie de première classeTable 1. First-class email properties and elements

Propriété de l’API managée EWSEWS Managed API property Élément EWSEWS element Propriété First-Class pour la méthode FindItems ou l’opération FindItem ?First-class property for the FindItems method or the FindItem operation? En lecture/écriture ou en lecture seuleRead-write or read-only
IdId
ItemIdItemId
OuiYes
Lecture seuleRead-only
ParentFolderIdParentFolderId
ParentFolderIdParentFolderId
OuiYes
Lecture seuleRead-only
ItemClassItemClass
ItemClassItemClass
OuiYes
En lecture/écritureRead-write
SubjectSubject
SubjectSubject
OuiYes
En lecture/écritureRead-write
SensitivitySensitivity
SensitivitySensitivity
OuiYes
Lecture seuleRead-only
CorpsBody
CorpsBody
NonNo
En lecture/écritureRead-write
AttachmentsAttachments
AttachmentsAttachments
NonNo
En lecture/écritureRead-write
DateTimeReceivedDateTimeReceived
DateTimeReceivedDateTimeReceived
OuiYes
Lecture seuleRead-only
TailleSize
TailleSize
OuiYes
Lecture seuleRead-only
CatégoriesCategories
CatégoriesCategories
NonNo
En lecture/écritureRead-write
ImportanceImportance
ImportanceImportance
OuiYes
En lecture/écritureRead-write
InReplyToInReplyTo
InReplyToInReplyTo
OuiYes
En lecture/écritureRead-write
IsSubmittedIsSubmitted
IsSubmittedIsSubmitted
OuiYes
Lecture seuleRead-only
IsDraftIsDraft
IsDraftIsDraft
OuiYes
Lecture seuleRead-only
IsFromMeIsFromMe
IsFromMeIsFromMe
OuiYes
Lecture seuleRead-only
IsResendIsResend
IsResendIsResend
OuiYes
Lecture seuleRead-only
IsUnmodifiedIsUnmodified
IsUnmodifiedIsUnmodified
OuiYes
Lecture seuleRead-only
InternetMessageHeadersInternetMessageHeaders
InternetMessageHeadersInternetMessageHeaders
NonNo
Lecture seuleRead-only
DateTimeSentDateTimeSent
DateTimeSentDateTimeSent
OuiYes
Lecture seuleRead-only
DateTimeCreatedDateTimeCreated
DateTimeCreatedDateTimeCreated
OuiYes
Lecture seuleRead-only
AllowedResponseActionsAllowedResponseActions
ResponseObjectsResponseObjects
NonNo
Lecture seuleRead-only
ReminderDueByReminderDueBy
ReminderDueByReminderDueBy
OuiYes
En lecture/écritureRead-write
IsReminderSetIsReminderSet
ReminderIsSetReminderIsSet
OuiYes
En lecture/écritureRead-write
ReminderMinutesBeforeStartReminderMinutesBeforeStart
ReminderMinutesBeforeStartReminderMinutesBeforeStart
OuiYes
En lecture/écritureRead-write
DisplayCcDisplayCc
DisplayCcDisplayCc
OuiYes
Lecture seuleRead-only
DisplayToDisplayTo
DisplayToDisplayTo
OuiYes
Lecture seuleRead-only
HasAttachmentsHasAttachments
HasAttachmentsHasAttachments
OuiYes
Lecture seuleRead-only
CultureCulture
CultureCulture
OuiYes
En lecture/écritureRead-write
EffectiveRightsEffectiveRights
EffectiveRightsEffectiveRights
OuiYes
Lecture seuleRead-only
LastModifiedNameLastModifiedName
LastModifiedNameLastModifiedName
OuiYes
Lecture seuleRead-only
LastModifiedTimeLastModifiedTime
LastModifiedTimeLastModifiedTime
OuiYes
Lecture seuleRead-only
IsAssociatedIsAssociated
IsAssociatedIsAssociated
OuiYes
En lecture/écritureRead-write
WebClientReadFormQueryStringWebClientReadFormQueryString
WebClientReadFormQueryStringWebClientReadFormQueryString
OuiYes
Lecture seuleRead-only
WebClientEditFormQueryStringWebClientEditFormQueryString
WebClientEditFormQueryStringWebClientEditFormQueryString
OuiYes
Lecture seuleRead-only
ConversationIdConversationId
ConversationIdConversationId
OuiYes
Lecture seuleRead-only
IndicateurFlag
IndicateurFlag
OuiYes
En lecture/écritureRead-write
InstanceKeyInstanceKey
InstanceKeyInstanceKey
OuiYes
Lecture seuleRead-only
EntityExtractionResultEntityExtractionResult
EntityExtractionResultEntityExtractionResult
NonNo
Lecture seuleRead-only
SenderSender
SenderSender
OuiYes
En lecture/écritureRead-write
ToRecipientsToRecipients
ToRecipientsToRecipients
NonNo
Lecture seuleRead-only
CcRecipientsCcRecipients
CcRecipientsCcRecipients
NonNo
Lecture seuleRead-only
BccRecipientsBccRecipients
BccRecipientsBccRecipients
NonNo
Lecture seuleRead-only
IsReadReceiptRequestedIsReadReceiptRequested
IsReadReceiptRequestedIsReadReceiptRequested
OuiYes
En lecture/écritureRead-write
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
OuiYes
En lecture/écritureRead-write
ConversationIndexConversationIndex
ConversationIndexConversationIndex
OuiYes
Lecture seuleRead-only
ConversationTopicConversationTopic
ConversationTopicConversationTopic
OuiYes
Lecture seuleRead-only
FromFrom
FromFrom
OuiYes
En lecture/écritureRead-write
InternetMessageIdInternetMessageId
InternetMessageIdInternetMessageId
OuiYes
Lecture seuleRead-only
IsReadIsRead
IsReadIsRead
OuiYes
En lecture/écritureRead-write
IsResponseRequestedIsResponseRequested
IsResponseRequestedIsResponseRequested
OuiYes
En lecture/écritureRead-write
ReplyToReplyTo
ReplyToReplyTo
NonNo
Lecture seuleRead-only
ReferencesReferences
ReferencesReferences
OuiYes
En lecture/écritureRead-write
ReceivedByReceivedBy
ReceivedByReceivedBy
OuiYes
Lecture seuleRead-only
ReceivedRepresentingReceivedRepresenting
ReceivedRepresentingReceivedRepresenting
OuiYes
Lecture seuleRead-only

Autres propriétés et éléments pour les messages électroniquesOther properties and elements for email messages

Tous les éléments et propriétés de messagerie importants ne sont pas des propriétés et des éléments de première classe.Not all important email properties and elements are first-class properties and elements. Pour obtenir les autres propriétés ou éléments, vous devez les ajouter à votre PropertySet si vous utilisez l’API managée EWS ou utiliser un chemin de propriété pour les ajouter à votre appel d’opération 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. Par exemple, pour récupérer le corps de texte et le contenu MIME d’un message, créez votre classe PropertySet comme indiqué pour la méthode 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, si vous utilisez EWS, ajoutez les éléments à l’élément AdditionalProperties dans votre demande d’opération GetItem , comme illustré ci-dessous.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>

Les propriétés EmailMessage héritées de l’objet SERVICEOBJECT de l’API managée EWS ne peuvent pas être incluses dans un jeu de propriétés pour la méthode Bind ; Toutefois, toutes les propriétés ServiceObject sont accessibles en lecture sur l’objet EmailMessage et sont récupérées par la méthode 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.

Tableau 2. Autres éléments et propriétés de messagerieTable 2. Other email properties and elements

Propriété de l’API managée EWSEWS Managed API property Élément EWSEWS element En lecture/écriture ou en lecture seuleRead-write or read-only
ArchiveTagArchiveTag
ArchiveTagArchiveTag
En lecture/écritureRead-write
ExtendedPropertiesExtendedProperties
ExtendedPropertyExtendedProperty
Lecture seuleRead-only
IconIndexIconIndex
IconIndexIconIndex
Lecture seuleRead-only
IsAttachmentIsAttachment
Non disponibleNot available
Lecture seuleRead-only
IsDirtyIsDirty
Non disponibleNot available
Lecture seuleRead-only
IsNewIsNew
Non disponibleNot available
Lecture seuleRead-only
ÉlémentItem
ÉlémentItem
Lecture seuleRead-only
MimeContentMimeContent
MimeContentMimeContent
Lecture seuleRead-only
Non disponibleNot available
MimeContentUTF8MimeContentUTF8
Lecture seuleRead-only
NormalizedBodyNormalizedBody
NormalizedBodyNormalizedBody
Lecture seuleRead-only
PolicyTagPolicyTag
PolicyTagPolicyTag
En lecture/écritureRead-write
AperçuPreview
AperçuPreview
En lecture/écritureRead-write
RetentionDateRetentionDate
RetentionDateRetentionDate
Lecture seuleRead-only
SchémaSchema
Non disponibleNot available
Lecture seuleRead-only
Service (Service)Service
Non disponibleNot available
Lecture seuleRead-only
StoreEntryIdStoreEntryId
StoreEntryIdStoreEntryId
Lecture seuleRead-only
TextBodyTextBody
TextBodyTextBody
Lecture seuleRead-only
UniqueBodyUniqueBody
UniqueBodyUniqueBody
Lecture seuleRead-only

Voir aussiSee also