Email propiedades y elementos en EWS en Exchange
Obtenga información sobre la primera clase y otras propiedades y elementos que puede obtener en los mensajes de correo electrónico mediante la API administrada de EWS o EWS en Exchange.
Email los mensajes tienen más de 50 propiedades y obtener las que desee, cuando los desee, puede resultar confuso si no sabe dónde buscar. Lo más importante que debe saber sobre cómo trabajar con propiedades y elementos de correo electrónico es que se incluyen en el conjunto de propiedades y elementos de primera clase devueltos por cada uno de los métodos y operaciones de recuperación principales. El conjunto de propiedades de primera clase que se devuelve varía en función del método de recuperación que use. También es importante no dejarse engañar por el valor AllProperties del elemento EWS BaseShape , que corresponde al valor de enumeración BasePropertySet.FirstClassMessageProperties en la API administrada de EWS. Este valor no incluye realmente todas las propiedades, solo incluye las propiedades de primera clase.
Propiedades y elementos de primera clase para mensajes de correo electrónico
El conjunto de propiedades y elementos de primera clase devueltos por el método EmailMessage.Bind de la API administrada de EWS y la operación GetItem de EWS es ligeramente diferente al conjunto de propiedades y elementos de primera clase devueltos por el método ExchangeService.FindItems de la API administrada de EWS y la operación FindItem de EWS. Las propiedades de primera clase devueltas por el método FindItems y la operación FindItem son un subconjunto de las propiedades devueltas por el método Bind y la operación GetItem . En la tabla 1 se enumeran todas las propiedades de primera clase devueltas por el método Bind y la operación GetItem , y se especifica cuál de ellas no se devuelve mediante el método FindItems o la operación FindItem . Tenga en cuenta que no puede ampliar el método FindItems ni la operación FindItem para recuperar propiedades y elementos adicionales, como ToRecipients, CcRecipients y BccRecipients. Si necesita recuperar esos valores, use el método FindItems o la operación FindItem para obtener los identificadores de elemento de los correos electrónicos y, a continuación, use el método Bind o la operación GetItem para recuperar las propiedades necesarias. Para ver ejemplos de código que muestran cómo recuperar elementos mediante el método Bind o FindItems , vea Obtener un elemento mediante la API administrada de EWS. Para ver ejemplos de código que muestran cómo recuperar elementos mediante las operaciones GetItem o FindItem , vea Obtener un elemento mediante EWS.
Las propiedades y los elementos de primera clase se enumeran en la tabla siguiente en el orden en que aparecen en una respuesta.
Tabla 1. Propiedades y elementos de correo electrónico de primera clase
Otras propiedades y elementos para mensajes de correo electrónico
No todas las propiedades y elementos de correo electrónico importantes son propiedades y elementos de primera clase. Para obtener las otras propiedades o elementos, debe agregarlas al conjunto de propiedades si usa la API administrada de EWS o usar una ruta de acceso de propiedad para agregarlas a la llamada a la operación de EWS. Por ejemplo, para recuperar el cuerpo del texto y el contenido MIME de un mensaje, cree el PropertySet como se muestra para el método Bind o Load .
PropertySet(BasePropertySet.IdOnly, ItemSchema.TextBody, ItemSchema.MimeContent);
O bien, si usa EWS, agregue los elementos al elemento AdditionalProperties en la solicitud de operación GetItem , como se muestra.
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:TextBody" />
<t:FieldURI FieldURI="item:MimeContent" />
</t:AdditionalProperties>
Las propiedades EmailMessage heredadas del objeto ServiceObject de api administrada de EWS no se pueden incluir en un conjunto de propiedades para el método Bind ; sin embargo, todas las propiedades ServiceObject son legibles en el objeto EmailMessage y el método Bind las recupera.
Tabla 2. Otras propiedades y elementos de correo electrónico
| Propiedad api administrada de EWS | Elemento EWS | Lectura y escritura o solo lectura |
|---|---|---|
| ArchiveTag |
ArchiveTag |
Lectura y escritura |
| ExtendedProperties |
ExtendedProperty |
Solo lectura |
| IconIndex |
IconIndex |
Solo lectura |
| IsAttachment |
No disponible |
Solo lectura |
| IsDirty |
No disponible |
Solo lectura |
| IsNew |
No disponible |
Solo lectura |
| Elemento |
Elemento |
Solo lectura |
| MimeContent |
MimeContent |
Solo lectura |
| No disponible |
MimeContentUTF8 |
Solo lectura |
| NormalizedBody |
NormalizedBody |
Solo lectura |
| PolicyTag |
PolicyTag |
Lectura y escritura |
| Vista previa |
Vista previa |
Lectura y escritura |
| RetentionDate |
RetentionDate |
Solo lectura |
| Esquema |
No disponible |
Solo lectura |
| Servicio |
No disponible |
Solo lectura |
| StoreEntryId |
StoreEntryId |
Solo lectura |
| TextBody |
TextBody |
Solo lectura |
| UniqueBody |
UniqueBody |
Solo lectura |