Email propriétés et éléments dans EWS dans Exchange
Découvrez les propriétés de première classe et les autres propriétés et éléments que vous pouvez obtenir sur les e-mails à l’aide de l’API managée EWS ou EWS dans Exchange.
Email messages ont plus de 50 propriétés, et obtenir celles que vous voulez, quand vous le souhaitez, peut être déroutant si vous ne savez pas où regarder. La chose la plus importante à savoir sur l’utilisation des propriétés et des éléments d’e-mail est de savoir qui sont inclus dans l’ensemble des propriétés et éléments de première classe retournés par chacune des principales méthodes et opérations de récupération. Le jeu de propriétés de première classe retourné varie en fonction de la méthode de récupération que vous utilisez. Il est également important de ne pas être dupé par la valeur AllProperties de l’élément BaseShape EWS, qui correspond à la valeur d’énumération BasePropertySet.FirstClassMessageProperties dans l’API managée EWS. Cette valeur n’inclut pas toutes les propriétés, elle inclut uniquement les propriétés de première classe.
Propriétés et éléments de première classe pour les messages électroniques
L’ensemble des propriétés et éléments de première classe retournés par la méthode EmailMessage.Bind de l’API managée EWS et l’opération GetItem EWS est légèrement différent de l’ensemble des propriétés et éléments de première classe retournés par la méthode ExchangeService.FindItems de l’API managée EWS et l’opération FindItem EWS. 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 . 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 retournées par la méthode FindItems ou l’opération FindItem . 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, CcRecipients et 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 e-mails, puis utilisez la méthode Bind ou l’opération GetItem pour récupérer les propriétés requises. 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 Obtenir un élément à l’aide de l’API managée EWS. Pour obtenir des exemples de code qui montrent comment récupérer des éléments à l’aide des opérations GetItem ou FindItem , consultez Obtenir un élément à l’aide d’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.
Tableau 1. Propriétés et éléments d’e-mail de première classe
Autres propriétés et éléments pour les messages électroniques
Tous les éléments et propriétés d’e-mail importants ne sont pas des propriétés et des éléments de première classe. 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. Par exemple, pour récupérer le corps du texte et le contenu MIME d’un message, créez votre PropertySet comme indiqué pour la méthode Bind ou Load .
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 indiqué.
<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 lisibles sur l’objet EmailMessage et sont récupérées par la méthode Bind.
Tableau 2. Autres propriétés et éléments d’e-mail
| Propriété d’API managée EWS | Élément EWS | Lecture-écriture ou lecture seule |
|---|---|---|
| ArchiveTag |
ArchiveTag |
Lecture-écriture |
| ExtendedProperties |
ExtendedProperty |
Lecture seule |
| IconIndex |
IconIndex |
Lecture seule |
| IsAttachment |
Non disponible |
Lecture seule |
| IsDirty |
Non disponible |
Lecture seule |
| IsNew |
Non disponible |
Lecture seule |
| Élément |
Élément |
Lecture seule |
| MimeContent |
MimeContent |
Lecture seule |
| Non disponible |
MimeContentUTF8 |
Lecture seule |
| NormalizedBody |
NormalizedBody |
Lecture seule |
| PolicyTag |
PolicyTag |
Lecture-écriture |
| Aperçu |
Aperçu |
Lecture-écriture |
| RetentionDate |
RetentionDate |
Lecture seule |
| Schéma |
Non disponible |
Lecture seule |
| Service |
Non disponible |
Lecture seule |
| StoreEntryId |
StoreEntryId |
Lecture seule |
| TextBody |
TextBody |
Lecture seule |
| UniqueBody |
UniqueBody |
Lecture seule |