DirectorySearcher.Filter-Eigenschaft

Ruft einen Wert ab, der das Format der Filterzeichenfolge für LDAP (Lightweight Directory Access Protocol) angibt, oder legt diesen fest.

Namespace: System.DirectoryServices
Assembly: System.DirectoryServices (in system.directoryservices.dll)

Syntax

'Declaration
Public Property Filter As String
'Usage
Dim instance As DirectorySearcher
Dim value As String

value = instance.Filter

instance.Filter = value

public string Filter { get; set; }

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

/** @property */
public String get_Filter ()

/** @property */
public void set_Filter (String value)

public function get Filter () : String

public function set Filter (value : String)

Eigenschaftenwert

Die Zeichenfolge für den Suchfilter im LDAP-Format, beispielsweise "(objectClass=user)". Der Standard ist "(objectClass=*)", wodurch alle Objekte abgerufen werden.

Hinweise

Für den Filter gelten folgende Richtlinien:

1. Die Zeichenfolge muss in Klammern eingeschlossen werden.

2. Ausdrücke können folgende relationalen Operatoren verwenden: <, <=, =, >= und >. Beispiel: "(objectClass=user)". Ein weiteres Beispiel ist "(lastName>=Davis)".

3. Verbundausdrücke werden mit den Präfixoperatoren & und | gebildet Beispiel: "(&(objectClass=user)(lastName= Davis))". Ein weiteres Beispiel: "(&(objectClass=printer)(|(building=42)(building=43)))".

Wenn der Filter ein Attribut vom Typ ADS_UTC_TIME enthält, muss der Wert das Format yymmddhhmmssZ haben, wobei y, m, d, h, m und s jeweils für Jahr, Monat, Tag, Stunde, Minute und Sekunde steht. Der Wert für die Sekunden (ss) ist optional. Der letzte Buchstabe Z bedeutet, dass keine Zeitdifferenz vorhanden ist. In diesem Format wird "10:20:00 A.M. May 13, 1999" zu "990513102000Z". Beachten Sie, dass Active Directory Datum und Uhrzeit in koordinierter Weltzeit (Coordinated Universal Time, UTC) speichert. Wenn Sie eine Zeit ohne Zeitdifferenz angeben, geben Sie die Zeit in UTC-Zeit an.

Wenn Sie sich nicht in der UTC-Zeitzone befinden, können Sie der UTC einen Differenzwert hinzufügen (anstatt Z anzugeben), um eine Zeit Ihrer Zeitzone anzugeben. Die Differenz berechnet sich folgendermaßen: Differenz = UTC-lokale Zeit. Geben Sie eine Differenz in folgendem Format an: yymmddhhmmss[+/-]hhmm. Ein Beispiel: "8:52:58 P.M. March 23, 1999" New Zealand Standard Time (die Differenz beträgt 12 Stunden) wird als "19990323205258.0+1200" angegeben.

Weitere Informationen über das Format der LDAP-Suchzeichenfolge finden Sie unter dem Thema "Search Filter Syntax" in der MSDN Library unter https://msdn.microsoft.com/library/deu (nur auf Englisch verfügbar).

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DirectorySearcher-Klasse
DirectorySearcher-Member
System.DirectoryServices-Namespace