E-Mail-Eigenschaften und Elemente in EWS in Exchange
Erfahren Sie mehr über die First-Class-und andere Eigenschaften und Elemente, die Sie über e-Mail-Nachrichten erhalten können, indem Sie die verwaltete EWS-API oder EWS in Exchange verwenden.
E-Mail-Nachrichten haben mehr als 50 Eigenschaften, und wenn Sie die gewünschten Objekte erhalten, kann dies verwirrend sein, wenn Sie nicht wissen, wo Sie suchen müssen. Das wichtigste, was Sie über das Arbeiten mit e-Mail-Eigenschaften und-Elementen wissen sollten, ist, dass Sie in der Gruppe der erstklassigen Eigenschaften und Elemente enthalten sind, die von den einzelnen Haupt Abrufmethoden und-Vorgängen zurückgegeben werden. Die zurückgegebene Gruppe von erstklassigen Eigenschaften variiert je nach der von Ihnen verwendeten Abrufmethode. Es ist auch wichtig, dass Sie sich nicht vom allproperties-Wert des BaseShape -EWS-Elements täuschen lassen, das dem BasePropertySet. FirstClassMessageProperties -Enumerationswert in der verwaltete EWS-API entspricht. Dieser Wert enthält nicht wirklich alle Eigenschaften, sondern nur die erstklassigen Eigenschaften.
Erstklassige Eigenschaften und Elemente für e-Mail-Nachrichten
Die Gruppe von erstklassigen Eigenschaften und Elementen, die von der verwaltete EWS-API Email Message. Bind -Methode und dem EWS- GetItem -Vorgang zurückgegeben werden, unterscheidet sich geringfügig von der Gruppe der Eigenschaften und Elemente der ersten Klasse, die von der verwaltete EWS-API Datei "ExchangeService. FindItems -Methode und dem EWS FindItem -Vorgang zurückgegeben werden. Die von der FindItems -Methode und der FindItem -Operation zurückgegebenen Eigenschaften der First-Klasse sind eine Teilmenge der Eigenschaften, die von der Bind -Methode und der GetItem -Operation zurückgegeben werden. In Tabelle 1 sind alle von der Bind -Methode und dem GetItem -Vorgang zurückgegebenen Eigenschaften der First-Klasse aufgeführt, und es wird angegeben, welche von diesen nicht von der FindItems -Methode oder der FindItem -Operation zurückgegeben werden. Beachten Sie, dass Sie die FindItems -Methode oder den FindItem -Vorgang nicht erweitern können, um zusätzliche Eigenschaften und Elemente wie torecipients, CcRecipientsund BccRecipientsabzurufen. Wenn Sie diese Werte abrufen möchten, verwenden Sie die FindItems -Methode oder den FindItem -Vorgang, um die Element-IDs der e-Mails abzurufen, und verwenden Sie dann die Bind -Methode oder die GetItem -Operation, um die erforderlichen Eigenschaften abzurufen. Codebeispiele, in denen gezeigt wird, wie Elemente mithilfe der Bind -oder der FindItems -Methode abgerufen werden, finden Sie unter Abrufen eines Elements mithilfe der verwaltete EWS-API. Codebeispiele, in denen gezeigt wird, wie Elemente mithilfe der GetItem -oder FindItem -Vorgänge abgerufen werden, finden Sie unter Abrufen eines Elements mithilfe von EWS.
Die Eigenschaften und Elemente der ersten Klasse werden in der folgenden Tabelle in der Reihenfolge aufgeführt, in der Sie in einer Antwort angezeigt werden.
Tabelle 1. Erstklassige e-Mail-Eigenschaften und-Elemente
Eigenschaft in der verwalteten EWS-API | EWS-Element | First-Class-Eigenschaft für die FindItems -Methode oder den FindItem -Vorgang? | Lese-/Schreibzugriff oder schreibgeschützt |
---|---|---|---|
Id |
ItemId |
Ja |
Schreibgeschützt |
ParentFolderId |
ParentFolderId |
Ja |
Schreibgeschützt |
ItemClass |
ItemClass |
Ja |
Lese-/Schreibzugriff |
Betreff |
Betreff |
Ja |
Lese-/Schreibzugriff |
Sensitivity |
Sensitivity |
Ja |
Schreibgeschützt |
Body |
Body |
Nein |
Lese-/Schreibzugriff |
Anlagen |
Anlagen |
Nein |
Lese-/Schreibzugriff |
DateTimeReceived |
DateTimeReceived |
Ja |
Schreibgeschützt |
Größe |
Größe |
Ja |
Schreibgeschützt |
Kategorien |
Kategorien |
Nein |
Lese-/Schreibzugriff |
Importance |
Importance |
Ja |
Lese-/Schreibzugriff |
InReplyTo |
InReplyTo |
Ja |
Lese-/Schreibzugriff |
Issubmitted |
Issubmitted |
Ja |
Schreibgeschützt |
IsDraft |
IsDraft |
Ja |
Schreibgeschützt |
Isfromme |
Isfromme |
Ja |
Schreibgeschützt |
IsResend |
IsResend |
Ja |
Schreibgeschützt |
IsUnmodified |
IsUnmodified |
Ja |
Schreibgeschützt |
InternetMessageHeaders |
InternetMessageHeaders |
Nein |
Schreibgeschützt |
DateTimeSent |
DateTimeSent |
Ja |
Schreibgeschützt |
DateTimeCreated |
DateTimeCreated |
Ja |
Schreibgeschützt |
AllowedResponseActions |
ResponseObjects |
Nein |
Schreibgeschützt |
ReminderDueBy |
ReminderDueBy |
Ja |
Lese-/Schreibzugriff |
Reminder |
ReminderIsSet |
Ja |
Lese-/Schreibzugriff |
ReminderMinutesBeforeStart |
ReminderMinutesBeforeStart |
Ja |
Lese-/Schreibzugriff |
DisplayCc |
DisplayCc |
Ja |
Schreibgeschützt |
Displayto ursprünglicher |
Displayto ursprünglicher |
Ja |
Schreibgeschützt |
HasAttachments |
HasAttachments |
Ja |
Schreibgeschützt |
Kultur |
Kultur |
Ja |
Lese-/Schreibzugriff |
EffectiveRights |
EffectiveRights |
Ja |
Schreibgeschützt |
LastModifiedName |
LastModifiedName |
Ja |
Schreibgeschützt |
LastModifiedTime |
LastModifiedTime |
Ja |
Schreibgeschützt |
Isassociated |
Isassociated |
Ja |
Lese-/Schreibzugriff |
WebClientReadFormQueryString |
WebClientReadFormQueryString |
Ja |
Schreibgeschützt |
WebClientEditFormQueryString |
WebClientEditFormQueryString |
Ja |
Schreibgeschützt |
ConversationId |
ConversationId |
Ja |
Schreibgeschützt |
Wert |
Wert |
Ja |
Lese-/Schreibzugriff |
InstanceKey |
InstanceKey |
Ja |
Schreibgeschützt |
EntityExtractionResult |
EntityExtractionResult |
Nein |
Schreibgeschützt |
Sender |
Sender |
Ja |
Lese-/Schreibzugriff |
ToRecipients |
ToRecipients |
Nein |
Schreibgeschützt |
CcRecipients |
CcRecipients |
Nein |
Schreibgeschützt |
BccRecipients |
BccRecipients |
Nein |
Schreibgeschützt |
IsReadReceiptRequested |
IsReadReceiptRequested |
Ja |
Lese-/Schreibzugriff |
IsDeliveryReceiptRequested |
IsDeliveryReceiptRequested |
Ja |
Lese-/Schreibzugriff |
ConversationIndex |
ConversationIndex |
Ja |
Schreibgeschützt |
ConversationTopic |
ConversationTopic |
Ja |
Schreibgeschützt |
From |
From |
Ja |
Lese-/Schreibzugriff |
InternetMessageId |
InternetMessageId |
Ja |
Schreibgeschützt |
IsRead |
IsRead |
Ja |
Lese-/Schreibzugriff |
IsResponseRequested |
IsResponseRequested |
Ja |
Lese-/Schreibzugriff |
ReplyTo |
ReplyTo |
Nein |
Schreibgeschützt |
References |
References |
Ja |
Lese-/Schreibzugriff |
ReceivedBy |
ReceivedBy |
Ja |
Schreibgeschützt |
ReceivedRepresenting |
ReceivedRepresenting |
Ja |
Schreibgeschützt |
Andere Eigenschaften und Elemente für e-Mail-Nachrichten
Nicht alle wichtigen e-Mail-Eigenschaften und-Elemente sind erstklassige Eigenschaften und Elemente. Um die anderen Eigenschaften oder Elemente abzurufen, müssen Sie Sie zu Ihrem PropertySet hinzufügen, wenn Sie die verwaltete EWS-API verwenden, oder einen Eigenschaftspfad verwenden, um Sie dem EWS-Vorgangsaufruf hinzuzufügen. Um beispielsweise den Textkörper und den MIME-Inhalt einer Nachricht abzurufen, erstellen Sie das PropertySet wie für die Bind -oder die Last -Methode dargestellt.
PropertySet(BasePropertySet.IdOnly, ItemSchema.TextBody, ItemSchema.MimeContent);
Wenn Sie EWS verwenden, fügen Sie die Elemente wie dargestellt zum AdditionalProperties -Element in Ihrer GetItem -Vorgangsanforderung hinzu.
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:TextBody" />
<t:FieldURI FieldURI="item:MimeContent" />
</t:AdditionalProperties>
Email Message -Eigenschaften, die vom verwaltete EWS-API serviceobject -Objekt geerbt wurden, können nicht in einen für die Bind -Methode festgelegten Eigenschaften enthalten sein; Allerdings sind alle serviceobject -Eigenschaften für das Email Message -Objekt lesbar und werden von der Bind -Methode abgerufen.
Tabelle 2. Andere e-Mail-Eigenschaften und-Elemente
Eigenschaft in der verwalteten EWS-API | EWS-Element | Lese-/Schreibzugriff oder schreibgeschützt |
---|---|---|
ArchiveTag |
ArchiveTag |
Lese-/Schreibzugriff |
ExtendedProperties |
ExtendedProperty |
Schreibgeschützt |
IconIndex |
IconIndex |
Schreibgeschützt |
Isattachment |
Nicht verfügbar |
Schreibgeschützt |
IsDirty |
Nicht verfügbar |
Schreibgeschützt |
IsNew |
Nicht verfügbar |
Schreibgeschützt |
Element |
Element |
Schreibgeschützt |
MimeContent |
MimeContent |
Schreibgeschützt |
Nicht verfügbar |
MimeContentUTF8 |
Schreibgeschützt |
NormalizedBody |
NormalizedBody |
Schreibgeschützt |
PolicyTag |
PolicyTag |
Lese-/Schreibzugriff |
Preview |
Preview |
Lese-/Schreibzugriff |
RetentionDate |
RetentionDate |
Schreibgeschützt |
Schema |
Nicht verfügbar |
Schreibgeschützt |
Service |
Nicht verfügbar |
Schreibgeschützt |
StoreEntryId |
StoreEntryId |
Schreibgeschützt |
TextBody |
TextBody |
Schreibgeschützt |
UniqueBody |
UniqueBody |
Schreibgeschützt |