Attachments and EWS in Exchange
Erfahren Sie mehr über Anlagen und wie Ihre verwaltete EWS-API oder EWS im Exchange-Client diese darstellt.
Normalerweise sind Anlagen E-Mail-Elementen zugeordnet, aber tatsächlich können alle EWS-Elemente – E-Mail-Nachrichten, Kalenderelemente, Kontakte, Aufgaben – Anlagen enthalten.
Typen von Anlagen
EWS kategorisiert Anlagen in zwei Gruppen: Dateianlagen und Elementanlagen.
Elementanlagen: Stark typisierte EWS-Elemente, z. B. E-Mail-Nachrichten und Kalenderelemente, die an ein anderes stark typisiertes EWS-Element angefügt sind. Jedes stark typisierte Element, das mithilfe der verwalteten EWS-API oder EWS erstellt werden kann, kann als Elementanlage verwendet werden. Der Inhalt einer Elementanlage ist das stark typisierte Element, das einfachen Zugriff auf alle eigenschaften bietet. Elementanlagen können eigene Elementanlagen haben, sodass eine Hierarchie von Elementanlagen (oder Schachtelung von Anlagen) möglich ist.
Dateianlagen: Jede Datei, z. B. eine .txt, .jpg, .zip, .pdf oder sogar eine MSG-Datei. Eine Dateianlage hat nur einige Eigenschaften, von denen eine der base64-codierten Inhalte der Datei ist.
Referenzanlagen: Jede Anlage, auf die von einem Dateianbieter verwiesen wird, z. B. eine Datei, die sich in der Cloud befindet. Eine Anlage kann von mehreren Anbietern stammen.
Wenn Sie Anlagen zu einem Element hinzufügen oder abrufen, wird dies je nachdem, ob es sich um eine Dateianlage oder eine Elementanlage handelt, anders ausgeführt. Wenn Sie beispielsweise einem Element eine Dateianlage hinzufügen möchten, können Sie einfach den Speicherort der Datei übergeben. Um ein vorhandenes Element als Elementanlage hinzuzufügen, müssen Sie die Eigenschaften oder den MIME-Inhalt des vorhandenen Elements in eine neue Elementanlage kopieren. Sie können nicht einfach eine Bindung an das vorhandene Element erstellen. Daher ist es wichtig, zwischen den beiden Anlagentypen zu unterscheiden. Weitere Details zu den Unterschieden zwischen Elementanlagen und Dateianlagen werden in den Artikeln in diesem Abschnitt erläutert.
Wie werden Anlagen programmgesteuert dargestellt?
Anlagen werden in einer Auflistung des EWS-Elements gespeichert. Die Anlagensammlung besteht aus Dateianlagen und/oder Elementanlagen. Metadaten zur Anlagensammlung sind verfügbar, wenn Sie ein Element mithilfe der EWS Managed API Item.Bind-Methode oder des EWS GetItem-Vorgangs abrufen, aber zusätzliche Aufrufe sind erforderlich, um den Inhalt der Anlagen tatsächlich abzurufen.
Tabelle 1. Elementmetadaten zu Anlagen
| Metadatenentität | Eigenschaft in der verwalteten EWS-API | EWS-Element |
|---|---|---|
| Anlagenindikator (kennzeichnet keine Inlineanlagen) |
Item.HasAttachments |
HasAttachments |
| Anlagensammlung |
Item.Attachments |
Anhänge |
| Anlagen-ID |
Attachment.Id |
AttachmentId |
Tabelle 2. Anlagenentitäten
| Anlagentyp | Verwaltete EWS-API-Klasse | EWS-Element |
|---|---|---|
| Dateianlage |
FileAttachment |
FileAttachment |
| Elementanlage |
ItemAttachment ItemAttachment<TItem> |
ItemAttachment |
| Verweisanlage |
ReferenceAttachmentType complexType (EWS) |
ReferenceAttachment |
Inlineanlagen
Inlineanlagen sind eine besondere Art von Anlage. Sowohl Dateianlagen als auch Elementanlagen können Inlineanlagen sein. Eine Inlineanlage wird als Teil des Textkörperinhalts angezeigt und behält ihre Position relativ zum restlichen Inhalt des Elements bei.
Eine Anlage ist eine Inlineanlage, wenn die IsInline-Eigenschaft der verwalteten EWS-API oder das EWS IsInline-Element auf "true" festgelegt ist. Inlineanlagen verwenden die folgenden optionalen Eigenschaften und Elemente, um den Speicherort einer Inlineanlage zu identifizieren:
Verwaltete EWS-API – ContentId- oder ContentLocation-Eigenschaften .
EWS – ContentId - oder ContentLocation-Element .
Beachten Sie, dass die HasAttachments-Eigenschaft der verwalteten EWS-API und das EWS HasAttachments-Element nicht das Vorhandensein von Inlineanlagen widerspiegeln. Deshalb werden Inlineanlagen auch als ausgeblendete Anlagen bezeichnet. Wenn Sie also die IsInline-Eigenschaft der verwalteten EWS-API oder das EWS IsInline-Element auf "true" festlegen und das Element keine anderen Anlagen aufweist, wird "HasAttachments " auf "false" festgelegt. Wenn Ihr Client HasAttachments verwendet, um eine Anlageanzeige oder ein Symbol in einer E-Mail aufzufüllen, beachten Sie, dass das Symbol für E-Mails mit Inlineanlagen nicht angezeigt wird.