_Table.Restrict(String) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Applique un filtre aux lignes du Table et obtient un nouvel objet Table .

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

Paramètres

Filter

String

Spécifie les critères des lignes dans l’objet Table .

Retours

Table

Objet Table retourné par application Filter aux lignes de l’objet Table parent.

Remarques

Vous pouvez uniquement utiliser Table.Restrict pour appliquer un autre filtre à cette table si l’objet parent de table est un Folder objet . Si l’objet parent est un Search objet, Restrict renvoie une erreur.

Étant donné que le filtre est appliqué aux lignes de l’objet Table, cela équivaut à appliquer un filtre qui est un AND logique de Filter et tous les filtres précédents appliqués au même objet Table .

Filter est une requête sur les propriétés spécifiées des éléments qui sont représentés sous forme de lignes dans la table parente. Cette requête utilise soit la syntaxe Microsoft Jet, soit la syntaxe DAV Searching and Locating (DASL). Par exemple, le filtre Jet et le filtre DASL suivants spécifient le même critère pour les éléments avec une date et une heure de dernière modification (LastModificationTime) antérieures à 15h30 le 12 juin 2005 :

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 ») & « ' »

Pour plus d’informations sur la spécification de filtres pour l’objet Table , consultez Filtrage d’éléments

Si Filter contient des propriétés personnalisées, ces propriétés doivent exister dans le dossier parent de l’objet Table pour que la restriction fonctionne correctement. Certaines propriétés ne sont pas prises en charge dans le filtre d’un objet Table, notamment les propriétés binaires, les propriétés calculées et le contenu du corps HTML ou RTF. Pour plus d’informations, consultez Propriétés non prises en charge dans un objet Table ou Filtre de table

Si Filter est une chaîne vide, Restrict renvoie un objet Table identique à l’objet Table parent.