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 zurückgegeben wird, indem Filter auf die Zeilen im übergeordneten Table-Objekt angewendet wird.

HinwBemerkungeneise

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

Table-Objekt

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.