Freigeben über


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

Siehe auch