_Table.Restrict(String) Methode

Definition

Wendet einen Filter auf die Zeilen im Table an und ruft ein neues Table-Objekt ab.

public:
 Microsoft::Office::Interop::Outlook::Table ^ Restrict(System::String ^ Filter);
public Microsoft.Office.Interop.Outlook.Table Restrict (string Filter);
Public Function Restrict (Filter As String) As Table

Parameter

Filter
String

Gibt die Kriterien für Zeilen im Table -Objekt an.

Gibt zurück

Ein Table-Objekt , das durch Anwenden auf Filter die Zeilen im übergeordneten Table-Objekt zurückgegeben wird.

Hinweise

Sie können Table.Restrict nur verwenden, um einen anderen Filter auf diese Tabelle anzuwenden, wenn das übergeordnete Objekt des Table-Objekts ein Folder -Objekt ist. Wenn das übergeordnete Objekt ein Search -Objekt ist, gibt 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 vorhergehenden 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$("12.06.2005 15:30 Uhr","Allgemeines Datum") & "'"

criteria = "@SQL=" & Chr(34) & "DAV:getlastmodified" & Chr(34) & " ' < " & Format$("12.06.2005 15:30 Uhr","Allgemein") & "'"

Weitere Informationen zum Angeben von Filtern für das Table-Objekt finden Sie unter Filtern von Elementen.

Wenn Filter benutzerdefinierte Eigenschaften enthalten sind, 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 Tabellenobjekt oder Tabellenfilter.

Wenn Filter eine leere Zeichenfolge ist, gibt Restrict ein Table-Objekt zurück, das mit dem übergeordneten Table-Objekt identisch ist.

Gilt für: