DirectorySearcher.Filter Propriété

Définition

Espace de noms:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paquet:

System.DirectoryServices v8.0.0

Source:

DirectorySearcher.cs

Obtient ou définit une valeur indiquant la chaîne de filtrage au format LDAP (Lightweight Directory Access Protocol).

public:
 property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };

public string? Filter { get; set; }

member this.Filter : string with get, set

Public Property Filter As String

Valeur de propriété

String

Chaîne de filtrage de recherche au format LDAP, par exemple "(objectClass=user)". La chaîne par défaut est "(objectClass=*)", qui récupère tous les objets.

Remarques

Le filtre utilise les instructions suivantes :

1. La chaîne doit être placée entre parenthèses.

2. Les expressions peuvent utiliser les opérateurs relationnels : <, <=, =, >=, et >. Par exemple, « (objectClass=user) ». Un autre exemple est « (lastName>=Davis) ».

3. Les expressions composées sont formées avec les opérateurs de préfixe & et |. Par exemple, « (&(objectClass=user)(lastName= Davis)) ». Un autre exemple est « (&(objectClass=printer)(|( building=42)(building=43)))) ».

Lorsque le filtre contient un attribut de ADS_UTC_TIME type, sa valeur doit être au format aaaammddhhmmsZ où y, m, d, h, m, m et s correspondent respectivement à l’année, au mois, au jour, à l’heure, à la minute et à la seconde. La valeur secondes (ss) est facultative. La lettre finale Z signifie qu’il n’y a pas de différentiel de temps. Dans ce format, « 10 :20 :00 A.M. may 13, 1999 » devient « 19990513102000Z ». Notez que services de domaine Active Directory stocke la date et l’heure en tant qu’heure universelle coordonnée (heure de Greenwich). Si vous spécifiez une heure sans différentiel d’heure, vous spécifiez l’heure en heure GMT.

Si vous n’êtes pas dans le fuseau horaire universel coordonné, vous pouvez ajouter une valeur différentielle au temps universel coordonné (au lieu de spécifier Z) pour spécifier une heure en fonction de votre fuseau horaire. Le différentiel est basé sur les éléments suivants : différentiel = Temps universel coordonné - Local. Pour spécifier un différentiel, utilisez le format suivant : aaaammmmdhhmmsss[+/-]hhmm. Par exemple, « 8 :52 :58 p.m. 23 mars 1999 » Heure standard de Nouvelle-Zélande (le différentiel est de 12 heures) est spécifié comme « 19990323205258.0+1200 ».

Pour plus d’informations sur le format de chaîne de recherche LDAP, consultez syntaxe de filtre Recherche.