Table.Restrict-Methode (Outlook)
Wendet einen Filter auf die Zeilen in der Tabelle, und es wird ein neues Table -Objekt abgerufen.
Syntax
Ausdruck.
Restrict( _Filter_ )
Ausdruck Eine Variable, die ein Table-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Filter | Erforderlich | String | Gibt die Kriterien für Zeilen im Table -Objekt an. |
Rückgabewert
Ein Table-Objekt , das durch Anwenden von Filter auf die Zeilen im übergeordneten Table-Objekt zurückgegeben wird.
Hinweise
Sie können nur Table.Restrict verwenden, um einen weiteren Filter zu dieser Tabelle gelten, wenn das übergeordnete Objekt der Tabelle ein Folder -Objekt ist. Wenn das übergeordnete Objekt ein Search -Objekt ist, wird die Restrict einen Fehler zurück.
Da der Filter auf die Zeilen im Table-Objekt angewendet wird, entspricht dies der Anwendung eines Filters, bei dem es sich um ein logisches AND von Filter und alle vorherigen Filter handelt, die auf dasselbe Table-Objekt angewendet werden.
Filter ist eine Abfrage für angegebene Eigenschaften von Elementen, die als Zeilen in der übergeordneten Tabelle dargestellt werden. Die Abfrage verwendet entweder die Microsoft Jet-Syntax oder die DASL-Syntax (DAV Searching and Locating). Der folgende Jet-Filter und DERL-Filter geben z. B. die gleichen Kriterien für Elemente mit LastModificationTime vor dem 12. Juni 2005 um 15:30 Uhr an:
criteria = "[LastModificationTime] < '" & Format$("6/12/2005 3:30PM","General Date") & "'"criteria = "@SQL=" & Chr(34) & "DAV:getlastmodified" & Chr(34)
& " < '" & Format$("6/12/2005 3:30PM","General Date") & "'"
Weitere Informationen zum Angeben von Filtern für das Table-Objekt finden Sie unter Filtern von Elementen.
Wenn Filter benutzerdefinierte Eigenschaften enthält, müssen diese Eigenschaften im übergeordneten Ordner des Table-Objekts vorhanden sein, damit die Einschränkung ordnungsgemäß funktioniert. Bestimmte Eigenschaften werden in einem Table -Filter, einschließlich binäre Eigenschaften, berechnete Eigenschaften und HTML- oder RTF-Textinhalte nicht unterstützt. Weitere Informationen finden Sie unter Nicht unterstützte Eigenschaften in einem Table-Objekt oder Table-Filter.
Wenn Filter eine leere Zeichenfolge ist, wird durch Restrict ein Table-Objekt zurückgegeben, das mit dem übergeordneten Table-Objekt identisch ist.
Beispiel
Im folgenden Codebeispiel weist einen Jet-Filter auf Elemente im Posteingang abrufen Elemente mit einem LastModificationTime größer als 1 November 2005. Druckt es dann die Werte der Standardeigenschaften für diese Elemente im Posteingang: EntryID, Subject, CreationTime, LastModificationTime und MessageClass.
Hinweis
[!HINWEIS] Da heterogene Elemente im gleichen Ordner in Outlook vorhanden sein können, können durch das Anwenden des Filters auf den Posteingang zurückgegebenen Elemente verschiedene Typen sein. Im Allgemeinen sollten Sie vor dem Zugriff auf alle Eigenschaften, die nicht zu den Standardeigenschaften für Elemente im Posteingang sind, MessageClass des Elements überprüfen.
Sub RestrictTable()
'Declarations
Dim Filter As String
Dim oRow As Outlook.Row
Dim oTable As Outlook.Table
Dim oFolder As Outlook.Folder
'Get a Folder object for the Inbox
Set oFolder = Application.Session.GetDefaultFolder(olFolderInbox)
'Define Filter to obtain items last modified after November 1, 2005
Filter = "[LastModificationTime] > '11/1/2005'"
'Restrict with Filter
Set oTable = oFolder.GetTable(Filter)
'Enumerate the table using test for EndOfTable
Do Until (oTable.EndOfTable)
Set oRow = oTable.GetNextRow()
Debug.Print (oRow("EntryID"))
Debug.Print (oRow("Subject"))
Debug.Print (oRow("CreationTime"))
Debug.Print (oRow("LastModificationTime"))
Debug.Print (oRow("MessageClass"))
Loop
End Sub
Siehe auch
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.