Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DirectorySearcher.Filter-Eigenschaft
Ruft einen Wert ab, der das Format der Filterzeichenfolge für LDAP (Lightweight Directory Access Protocol) angibt, oder legt diesen fest.
Assembly: System.DirectoryServices (in System.DirectoryServices.dll)
[DSDescriptionAttribute("DSFilter")] [TypeConverterAttribute("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")] [SettingsBindableAttribute(true)] public string Filter { get; set; }
Eigenschaftswert
Typ: System.StringDie Zeichenfolge für den Suchfilter im LDAP-Format, beispielsweise "(objectClass=user)". Der Standard ist "(objectClass=*)", wodurch alle Objekte abgerufen werden.
Für den Filter gelten folgende Richtlinien:
-
Die Zeichenfolge muss in Klammern eingeschlossen werden.
-
Ausdrücke können folgende relationalen Operatoren verwenden: <, <=, =, >= und >. Beispiel: "(objectClass=user)". Ein weiteres Beispiel ist "(lastName>=Davis)".
-
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 yyyymmddhhmmssZ aufweisen, 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 "19990513102000Z". Beachten Sie, dass Active Directory-Domänendienste 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: yyyymmddhhmmss[+/-]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 Zeichenfolgenformat für LDAP-Suchen finden Sie unter dem Thema "Search Filter Syntax" in der MSDN Library unter http://msdn.microsoft.com/de-de/library/default.aspx (nur auf Englisch verfügbar).
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
