Ordner und Elemente in EWS in Exchange

Erfahren Sie mehr über Ordner und Postfachelemente und deren Darstellung durch die verwaltet EWS-API oder den EWS-Client.

Ordner sind das Organisationselement eines Exchange-Postfachs. Ordner enthalten Postfachelemente, wie z. B. E-Mail-Nachrichten, Kontakte, Termine, Besprechungen und Aufgaben, und sie können auch andere Ordner beinhalten. Exchange beinhaltet verschiedene Arten von Ordnern, wobei sich die Ordnertypen jedoch ähneln. Der Hauptunterschied zwischen ihnen besteht darin, welche Art von Element sie enthalten.

Die Elemente weisen jedoch eindeutige Typen auf. Jeder Typ hat einen anderen Satz von Eigenschaften oder ein Schema, das ihn definiert. In diesem Artikel werden die Typen von Ordnern und Elementen erläutert, die zur Verfügung stehen, und wie sie sich unterscheiden.

Ordner

Ordner werden von der gleichen Basisklasse oder dem gleichen Basistyp abgeleitet: der Folder-Klasse in der verwalteten EWS-API oder dem Ordner-Typ in EWS. In der folgenden Abbildung sind die verwalteten EWS-API-Klassen und die EWS-Typen dargestellt.

Abbildung 1: Verwaltete EWS-API-Ordnerklassen und EWS-Ordnertypen

Eine Abbildung der Klassen, die von der

Der Hauptunterschied zwischen den Ordnerklassen und Ordnertypen besteht darin, dass Sie nur einen bestimmten Elementtyp in den einzelnen Ordnertypen erstellen können. Ein weitere Unterschied liegt darin, wie der Client die Informationen in einem Ordner anzeigt. So können Sie in Exchange zum Beispiel Termine im Kalenderordner erstellen. Sie können andere Elementtypen in den Kalenderordner verschieben, nachdem Sie sie erstellt haben, sie werden in Outlook jedoch nicht angezeigt. Outlook zeigt im Kalenderordner nur Kalenderelemente wie Termine oder Besprechungen an, auch wenn andere Elementtypen im Ordner vorhanden sind.

Tabelle 1. Verwaltete EWS-API-Ordnerklassen und EWS-Ordnertypen

Verwaltete EWS-API-Klasse EWS-Typ FolderClass-Wert Contains Hinweise
Folder
Ordner
IPF.Note
E-Mail-Nachrichten oder -Ordner
Dies ist die allgemeine Ordnerklasse oder der allgemeine Typ für die folgenden WellKnownFolderName-Ordner der verwalteten EWS-API und der DistinguishedFolderId-Ordner von EWS:
  • Stamm (IPM-Unterstruktur)
  • NonIpmSubtree
  • Posteingang
  • Gelöschte Elemente
  • Entwürfe
  • Journal
  • Notizen
  • Postausgang
  • Gesendete Elemente
  • Nachrichtenordner
  • Junk-E-Mail
  • Voicemail
CalendarFolder
CalendarFolder
IPF.Appointment
Termine und Besprechungen
Wenn ein Benutzer auf eine Besprechungsanfrage antwortet, wird der Termin nur dem WellKnownFolderName.Calendar der verwalteten EWS-API oder dem DistinguishedFolderId.CalendarFolder von EWS hinzugefügt. Diese sind die einzigen Ordner, die die automatische Interaktion mit Besprechungsanfragen und -antworten unterstützen.

Diese Ordnerklasse oder dieser Ordnertyp unterstützt die Verwendung von Kalenderansichten, um Termine und Besprechungen basierend auf einem Start- und Enddatum zurückzugeben. Hierzu werden die Folder.FindItem-Methode und die CalendarView-Klasse der verwalteten EWS-API oder der FindItem-Vorgang und das CalendarView-Element von EWS verwendet.
ContactsFolder
ContactsFolder
IPF.Contact
Kontakte und Verteilerlisten
Keine.
SearchFolder
SearchFolder
IPF.Note
Inhalte werden durch eine Einschränkung oder einen Filter bestimmt. Suchordner enthalten keine Unterordner.
Die Elemente, die den Suchkriterien entsprechen, sind nicht tatsächlich im Suchordner enthalten. Sie befinden sich stattdessen an anderer Stelle im Posteingang.
Um sicherzustellen, dass Suchordner in Outlook verfügbar sind, erstellen Sie sie im Ordner „Finder".
TasksFolder
TasksFolder
IPF.Task
Enthält zu erledigende Arbeitselemente.
Keine.

Ordnerstruktur

Ordner bieten eine Postfachstruktur. Dazu gehören die IPM-Unterstruktur, die in EWS als oberste Ebene des Informationsspeichers bezeichnet wird, wo die meisten Benutzer mit ihrem Postfach interagieren, und Systemordner, die den meisten Benutzern nie angezeigt werden und die sich in EWS in der Nicht-IPM-Unterstruktur oder Stamm befinden. Die folgende Abbildung zeigt die Ordnerstruktur für einen Benutzer und gibt an, welche Ordner Elemente des Benutzers enthalten und welche Systemordner sind.

Abbildung 2: Element- und Systemordner in einem Postfach

Eine Abbildung der Systemordner am Stamm, wozu u. a.

Bekannte Ordner

Einige der Ordner im Postfach sind spezielle Ordner. Diese entsprechen bekannten Ordnern in der verwalteten EWS-API oder definierten Ordnern in EWS. Für einige dieser Ordner gelten Einschränkungen hinsichtlich der Ordnernamen, wo sie sich in der Ordnerstruktur befinden, und ob sie gelöscht werden können. Andere allgemeine (nicht spezielle) Ordner haben nicht die gleichen Einschränkungen. Es ist wichtig, dass Sie die folgenden bekannten oder definierten Ordner kennen, da es sich hierbei um die Stammsystem-, Benutzer- und Suchordner handelt, die für die meisten Implementierungen gelten.

Tabelle 2. Primäre bekannte und definierte Ordner

Anzeigename WellKnownFolderName-Werte der verwalteten EWS-API DistinguishedFolderId-Wete von EWS Beschreibung
Stamm (Nicht-IPM-Unterstruktur)
WellKnownFolderName.Root
DistinguishedFolderId.root
Enthält den Stammordner eines Postfachs, der auch als „Nicht-IPM-Unterstruktur" bezeichnet wird. Dieser Ordner hat kein übergeordnetes Element, und Sie können ihn nicht verschieben, kopieren, umbenennen oder löschen. Jeder Nachrichtenspeicher enthält nur einen Stammordner.
Oberste Ebene des Informationsspeichers (IPM-Unterstruktur)
WellKnownFolderName.MsgFolderRoot
DistinguishedFolderId.msgfolderroot
Enthält den Posteingang und andere Benutzerordner.
Finder (Suchordner)
WellKnownFolderName.SearchFolders
DistinguishedFolderId.searchfolders.
Enthält die in Outlook sichtbaren Suchordner.

Eine vollständige Liste der WellKnownFolderName-Eigenschaftenwerte der verwalteten EWS-API finden Sie in der WellKnownFolderName-Enumeration. Eine vollständige Liste der DistinguishedFolderId-Werte in EWS finden Sie unter DistinguishedFolderId.

Ordnereigenschaften

In der verwalteten EWS-API werden alle Ordnereigenschaften von der Folder-Basisklasse abgeleitet. And in EWS, all folders use the folder elements that are available on the Ordner type. Most of the folder-related properties and elements are straightforward (parent folder ID, display name, and so on), but a few require a little more explanation.

Die folgenden Bedingungen gelten für die Folder.FolderClass-Eigenschaft der verwalteten EWS-API oder das FolderClass-Element in EWS:

  • Wenn festgelegt, muss der Wert der Eigenschaft oder des Elements mit der abgeleiteten Klassen oder dem Typ des Ordners übereinstimmen. So kann die FolderClass -Eigenschaft oder das Element nicht angeben, dass es sich bei dem Ordner um einen Kontaktordner handelt, während die Klasse oder der Typ des Ordners angibt, dass es sich um einen Kalenderordner handelt.

  • Sie können entweder Ordner erstellen, die einen bestimmten Typ haben, ohne die FolderClass -Eigenschaft oder das Element festzulegen, oder Sie können einen allgemeinen Ordnertyp erstellen und die FolderClass -Eigenschaft oder das Element festlegen. Mit beiden Optionen erzielen Sie das gleiche Ergebnis.

  • Nachdem Sie den FolderClass-Wert durch Erstellen eines bestimmten Ordnertyps oder durch Festlegen der FolderClass-Eigenschaft oder des Elements selbst festgelegt haben, können Sie ihn nicht mehr ändern. Beispielsweise können Sie eine IPF nicht ändern. Notieren Sie den Ordner für einen IPF. Kontaktordner. Sie können ihn jedoch in einen IPF ändern. Note.Contoso-Ordner.

  • Jeder FolderClass -Wert, der nicht eines der vordefinierten Präfixe verwendet, wird als ein IPF.Note-Ordner behandelt. So wird ein FolderClass -Wert der IAmAFolderClass als ein IPF.Note-Ordner behandelt.

Der Ordnerklassenwert ist erweiterbar. Dies bedeutet, dass die in Tabelle 1 aufgeführten FolderClass -Standardwerte als Präfixe behandelt werden und Sie benutzerdefinierte Werte hinzufügen können. Sie können beispielsweise einen Ordner mit dem FolderClass -Wert IPF.Contact.Contoso erstellen, und dieser wird dann als Kontaktordner behandelt.

Sie können festlegen, welche Berechtigungen der Client für die Ordner hat, zum Beispiel Löschen, Lesen und Ändern, indem Sie die Folder.EffectiveRights-Eigenschaft der verwalteten EWS-API oder das EffectiveRights-Element in EWS verwenden.

Öffentliche Ordner

Öffentliche Ordner ermöglichen den gemeinsamen Zugriff und stellen ein einfaches und effektives Mittel zum Erfassen, Organisieren und Freigeben von Informationen für andere Personen in der Arbeitsgruppe oder Organisation dar. Sie können öffentliche Ordner auch zum Archivieren von Verteilergruppeninhalt verwenden. Ausführliche Informationen über öffentliche Ordner finden Sie unter Zugriff auf Öffentliche Ordner mit EWS in Exchange.

Ausgeblendete Ordner

Alle Ordner, die Exchange im Stamm des Postfachs erstellt, sind ausgeblendet. Sie können die verwaltete EWS-API oder EWS verwenden, um weitere Ordner auf der obersten Ebene des Informationsspeichers auszublenden. Weitere Informationen zu ausgeblendeten Ordnern finden Sie unter Arbeiten mit ausgeblendeten Ordnern mit EWS in Exchange.

Suchordner

Suchordner sind genau wie reguläre Ordner, mit der Ausnahme, dass sie über eine Eigenschaft oder ein Element verfügen, das den Suchfilter definiert. Sie können Suchordner in einem beliebigen Ordner in einem Exchange-Postfach erstellen und auf die gleiche Weise erstellen, wie Sie andere Ordner erstellen. Damit jedoch ein Suchordner in Outlook, Outlook Web App oder Outlook Live angezeigt wird, müssen sich SearchFolder-Objekte, die Sie mit der verwalteten EWS-API erstellen, im Ordner WellKnownFolderName.SearchFolders befinden, und SearchFolder-Typen, die Sie mit EWS erstellen, müssen sich im Ordner DistinguishedFolderId.SearchFolders befinden. Wenn der Suchordner an einem anderen Speicherort erstellt wird, ist er weiterhin verfügbar, und Sie können ihn in benutzerdefinierten Clientanwendungen anzeigen.

Elemente

EWS in Exchange verwendet Items, die E-Mail-Nachrichten, Termine, Besprechungen, Kontakte, Verteilerlisten, Aufgaben, Posts und andere Elemente in einer Mailbox darstellen. Items haben entweder eine starke Typisierung, was bedeutet, dass ihnen eine spezifische Klasse oder ein Schema zugewiesen ist, oder eine nicht starke Typisierung, wobei sie dann als generische Items bezeichnet werden. Generische Items sind Item-Objekte in der verwalteten EWS-API und Item-Typen in EWS. Häufige Items wie E-Mail-Nachrichten, Kontakte, Verteilerlisten, Posts und Aufgaben haben eine starke Typisierung, und Sie können bestimmte Schemaeigenschaften oder -elemente dafür festlegen.

Tabelle 3. Stark typisierten Elemente

Verwalteter EWS-API-Elementtyp EWS-Item-Element
Appointment
CalendarItem
Contact
Contact
ContactGroup
DistributionList
EmailMessage
Message
PostItem
PostItem
Task
Task

Stark typisierte Items der verwalteten EWS-API werden von der Item-Basisklasse abgeleitet. Sie arbeiten jedoch im Allgemeinen mit einem der in Tabelle 3 aufgeführten abgeleiteten Typen, und nicht mit der Item -Klasse direkt. Wenn Sie die ItemCollection-Klasse verwenden, arbeiten Sie jedoch möglicherweise direkt mit Instanzen der Item -Klasse. In diesem Fall sollten Sie Logik implementieren, die den Typ des Elements im Store festlegt, den die Instanz in der Item -Klasse darstellt. Um mit diesem Item arbeiten zu können, müssen Sie eine Bindung zu dem Item herstellen, indem Sie eine Instanz der Klasse verwenden, die das Item darstellt.

Items in Ordnern

Bei einigen Ordnern gelten Einschränkungen für die Typen von Items, die sie beinhalten können. Hierbei handelt es sich Einschränkungen, die die Exchange-Postfachdatenbank auf Ordner anwendet, nicht um Einschränkungen der Clientansicht.

Tabelle 4. Item-Einschränkungen für Ordner

Verwaltete EWS-API-Ordnerklasse EWS-Ordnertyp Einschränkung
Base Folder-Klasse
Ordner
Sie können nur neue EWS Managed API EmailMessage-Objekte und PostItem-Objekte oder EWS-Nachrichtentypen oder PostItem-Typen in den generischen Ordnern erstellen. Sie können andere Elementtypen in generische Ordner verschieben, aber der Client zeigt sie möglicherweise nicht an.
CalendarFolder
CalendarFolder
Sie können nur neue Appointment-Objekte der verwalteten EWS-API und CalendarItem-Typen in EWS im Kalenderordner erstellen. Sie können andere Item-Typen in den Kalenderordner verschieben, wobei der Client diese möglicherweise jedoch nicht anzeigen kann.
ContactsFolder
ContactsFolder
Sie können nur neue Contact-Objekte und ContactGroupObjekte der verwalteten EWS-API oder Contact-Typen oder DistributionList-Typen in EWS im Kontaktordner erstellen. Sie können andere Item-Typen in den Kontaktordner verschieben, wobei der Client diese möglicherweise jedoch nicht anzeigen kann.
SearchFolder
SearchFolder
Keine Einschränkungen. Elemente befinden sich nicht tatsächlich im Ordner "Suche". sie befinden sich an einer anderen Stelle im Postfach.
TasksFolder
TasksFolder
Sie können nur neue Task-Objekte der verwalteten EWS-API oder Task-Typen in EWS im Aufgabenordner erstellen. Sie können andere Item-Typen in den Aufgabenordner verschieben, wobei der Client diese möglicherweise jedoch nicht anzeigen kann.

Aktualisieren von früheren Produktversionen

Ordner haben sich in früheren und in den aktuellen Produktversionen kaum geändert. Beachten Sie jedoch, dass frühere Versionen von Exchange verwaltete Ordner verwenden, um die Messaging-Datensatzverwaltung (MRM) durchzuführen. Exchange Online, Exchange Online als Teil von Office 365 und Exchange-Versionen ab Exchange 2013 verwenden Aufbewahrungsrichtlinien für MRM. Sie können verwaltete Ordner für die Verwendung von Aufbewahrungsrichtlinien aktualisieren.

Items wurden in früheren und aktuellen Produktversionen nicht geändert.

Inhalt dieses Abschnitts

Siehe auch