Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Ein mailSearchFolder ist ein virtueller Ordner im Postfach des Benutzers, der alle E-Mail-Elemente enthält, die den angegebenen Suchkriterien entsprechen. mailSearchFolder erbt von mailFolder. Suchordner können in jedem Ordner im Exchange Online Postfach eines Benutzers erstellt werden. Damit ein Suchordner in Outlook-Clients angezeigt wird, unterscheidet sich der erforderliche Speicherort jedoch je nach Client:
- In Outlook für Windows muss der Ordner unter WellKnownFolderName.SearchFolders erstellt werden.
- In Outlook im Web und New Outlook für Windows muss der Ordner unter SearchFoldersView erstellt werden.
Lebenszyklus von Suchordnern
Von Ihrer Anwendung erstellte Suchordner können aus einem der folgenden Gründe von Exchange Online gelöscht werden:
- Suchordner laufen nach 45 Tagen ohne Nutzung ab.
- Es gibt Grenzwerte für die Anzahl der Suchordner, die pro Quellordner erstellt werden können. Wenn dieser Grenzwert überschritten wird, werden ältere Suchordner gelöscht, um Neue zu schaffen.
Wenn ein Suchordner gelöscht wird, sollte Ihre App eine neue Suchordnerressource erstellen und dieselbe verwenden.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Suchordner für E-Mail erstellen | mailSearchFolder | Erstellen Sie einen Suchordner im Postfach dieses Benutzers. |
| Untergeordnete Ordner auflisten | mailFolder-Sammlung | Listet alle Ordner im Postfach dieses Benutzers auf, einschließlich Suchordnern. |
| Suchordner für E-Mail abrufen | mailSearchFolder | Ruft den angegebenen Suchordner ab. |
| Suchordner für E-Mail aktualisieren | mailSearchFolder | Aktualisieren Sie den angegebenen Suchordner. |
| Suchordner für E-Mail löschen | Keine | Löschen Sie den angegebenen Suchordner. |
| Endgültig löschen | Keine | Löschen Sie einen E-Mail-Suchordner endgültig, und entfernen Sie seine Elemente aus dem Postfach des Benutzers. |
| Nachrichten im Ordner auflisten | message-Sammlung | Listet alle Nachrichten im angegebenen Suchordner auf. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| filterQuery | Zeichenfolge | Die OData-Abfrage zum Filtern der Nachrichten. |
| includeNestedFolders | Boolean | Gibt an, wie die Postfachordnerhierarchie bei der Suche durchlaufen werden soll.
true bedeutet, dass eine umfassende Suche durchgeführt werden sollte, um untergeordnete Ordner in die Hierarchie jedes Ordners einzuschließen, die explizit in sourceFolderIds angegeben sind.
false bezeichnet eine flache Suche nur der einzelnen Ordner, die explizit in sourceFolderIds angegeben sind. |
| isSupported | Boolean | Gibt an, ob ein Suchordner mithilfe von REST-APIs bearbeitet werden kann. |
| sourceFolderIds | String collection | Die Postfachordner, die mined werden sollen. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"isSupported": true,
"includeNestedFolders": true,
"sourceFolderIds": ["string"],
"filterQuery": "string"
}