Aufzählen, Suchen und Filtern von Elementen in einem Ordner
Im Outlook-Objektmodell werden mehrere Einstiegspunkte bereitgestellt, die das Aufzählen, Suchen und Filtern von Elementen in einem Ordner unterstützen.
Aufzählen von Elementen
Die Objekte Items, Table und Selection unterstützen das Aufzählen von Elementen in einem Ordner. Es gibt jedoch bestimmte Szenarien, in denen Sie eines der Objekte gegenüber den anderen bevorzugen würden.
Sie können eine Items -Auflistung abrufen, indem Sie Folder.Items aufrufen, wodurch die Elemente im Ordner zurückgegeben werden. Jedes Elementobjekt in der Auflistung ist vollständig mit den expliziten integrierten Eigenschaften und benutzerdefinierten Eigenschaften und unterstützt Lese-/Schreibvorgänge. Die Items -Auflistung unterstützt außerdem Filter und Ereignisse, die ausgelöst werden, wenn Elemente in der Auflistung hinzugefügt, geändert oder entfernt werden.
Verwenden Sie Folder.GetTable oder Search.GetTable , um ein Table-Objekt abzurufen, das eine Gruppe von Elementen in einem Ordner oder Suchordner darstellt. In beiden Fällen können Sie einen Filter angeben, um eine Teilmenge der Elemente im Ordner abzurufen, oder, wenn Sie keinen Filter angeben, alle Elemente im Ordner abrufen. By default, each item in the returned Table contains only a default subset of its properties.
You can view each row of a Table as an item in the folder, each column as a property of the item, and the Table is an in-memory light-weight rowset that allows fast enumeration and filtering of items in the folder. Although additions and deletions of the underlying folder are reflected by the rows in the Table, the Table does not support any events for adding, changing, and removing rows.
If you require a writeable object from the Table row, obtain the Entry ID for that row from the default EntryID column in the Table and then use the GetItemFromID method of the NameSpace object to obtain a full item, such as a MailItem or ContactItem, that supports read-write operations. Weitere Informationen zu Standardspalten in einer Tabelle finden Sie unter efault-Eigenschaften, die in einem Table-Objekt angezeigt werden.
Das Selection -Objekt unterstützt das Aufzählen von Elementen, die ein Benutzer zurzeit in einem Explorer ausgewählt hat. Da im Explorer der Inhalt eines Ordners angezeigt wird, unterstützt das Selection -Objekt die Aufzählung der vom Benutzer ausgewählten Elemente in diesem Ordner.
Hinweis Ein Ordner in Outlook kann heterogene Elemente enthalten. For example, the Contacts folder supports creating contact items and distribution list items by default. Da die Items-, Table- und Selection-Objekte Elemente in einem Ordner oder Suchordner kapseln, verfügen die darin enthaltenen Elemente nicht unbedingt über die gleiche Nachrichtenklasse. When enumerating items in these collections and objects, it is a good practice to first check for the message class of each item before accessing the item's properties.
Suchen und Filtern von Elementen
Die Objekte Items, Table, Application und View unterstützen das Suchen und Filtern von Elementen in einem Ordner. In der folgenden Tabelle werden diese Einstiegspunkte beschrieben und verglichen:
| Einstiegspunkt | Aktion | Objekt des Suchfilters | Jetfilterunterstützung | DASL-Filterunterstützung | Kommentare |
|---|---|---|---|---|---|
| Application.AdvancedSearch | Die Kriterien für ein Search-Objekt werden festgelegt, und das Search-Objekt wird zurückgegeben. Search.Results gibt die Suchergebnisse an. Search.Save aktualisiert einen Suchordner mit den Suchergebnissen. | Ordner | Nein | Ja | |
| Folder.GetTable | Es wird basierend auf einem bestimmten Filter ein Table-Objekt mit Elementen in einem Ordner zurückgegeben. | Ordner | Ja | Ja | Bestimmte Eigenschaften werden im Table-Filter nicht unterstützt, z. B. binäre Eigenschaften und HTML- oder RTF-Textinhalte. Weitere Informationen finden Sie unter Nicht unterstützte Eigenschaften in einem Table-Objekt oder Table-Filter. |
| Items.Find | Es wird nach dem ersten Element gesucht, das dem angegebenen Filter entspricht. | Ordner | Ja | Nein | Bestimmte Eigenschaften, z. B. Body, werden im Filter nicht unterstützt. Weitere Informationen finden Sie unter Items.Find. |
| Items.Restrict | Der angegebene Satz Elemente wird basierend auf angegebenen Beschränkungen gefiltert, und es wird eine weitere Items-Auflistung zurückgegeben. | Ordner | Ja | Ja | Bestimmte Eigenschaften, z. B. Body, werden im Filter nicht unterstützt. Weitere Informationen finden Sie unter Items.Restrict. |
| Search.GetTable | Es wird ein Table-Objekt der Elemente in einem Suchordner basierend auf einem von Application.AdvancedSearch abgeleiteten Filter zurückgegeben. | Suchordner | Nein | Ja | Search.GetTable leitet seinen Filter vom Search-Objekt (insbesondere der Search.Filter-Eigenschaft ) ab, das von Application.AdvancedSearch zurückgegeben wird. |
| Table.Restrict | Die Zeilen in der angegebenen Tabelle werden basierend auf einem angegebenen Filter gefiltert, und es wird ein weiteres Table-Objekt zurückgegeben. | Ordner | Ja | Ja | Bestimmte Eigenschaften werden im Table-Filter nicht unterstützt, z. B. binäre Eigenschaften und HTML- oder RTF-Textinhalte. Weitere Informationen finden Sie unter Nicht unterstützte Eigenschaften in einem Table-Objekt oder Table-Filter. |
| View.Filter | Der Filter einer Ansicht wird festgelegt, ohne den XML-Code der Ansicht zu ändern. Das Festlegen des Filters für eine Ansicht ändert nur die Ansicht in der Benutzeroberfläche und führt nicht zu einer gefilterten Items-Auflistung . | Ordner | Nein | Ja | |
| View.XML | Ruft den XML-Code für eine Ansicht ab oder legt diese fest. Wenn Sie den <Knoten Filter> ändern, wird der Filter der Ansicht geändert. Das Festlegen des XML-Codes für eine Ansicht ändert nur die Ansicht in der Benutzeroberfläche und führt nicht zu einer gefilterten Items-Auflistung . | Ordner | Nein | Ja | View.XML ist als veraltet markiert. Verwenden Sie zum Programmieren von Ansichten das View-Objektmodell. |
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.