DirectorySearcher.Filter Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der das Format der Filterzeichenfolge für LDAP (Lightweight Directory Access Protocol) angibt, oder legt diesen fest.
public:
property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };
public string Filter { get; set; }
public string? Filter { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.DirectoryServices.DSDescription("DSFilter")]
public string Filter { get; set; }
[System.DirectoryServices.DSDescription("DSFilter")]
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }
[System.DirectoryServices.DSDescription("DSFilter")]
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }
member this.Filter : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.DirectoryServices.DSDescription("DSFilter")>]
member this.Filter : string with get, set
[<System.DirectoryServices.DSDescription("DSFilter")>]
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Filter : string with get, set
[<System.DirectoryServices.DSDescription("DSFilter")>]
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Filter : string with get, set
Public Property Filter As String
Eigenschaftswert
Die Zeichenfolge für den Suchfilter im LDAP-Format, beispielsweise "(objectClass=user)". Der Standard ist "(objectClass=*)", wodurch alle Objekte abgerufen werden.
- Attribute
Hinweise
Der Filter verwendet die folgenden Richtlinien:
Die Zeichenfolge muss in Klammern eingeschlossen werden.
Ausdrücke können die relationalen Operatoren verwenden: <, <=, =, =, >und >. Ein Beispiel ist "(objectClass=user)". Ein weiteres Beispiel ist "(lastName>=Davis)".
Zusammengesetzte Ausdrücke werden mit den Präfixoperatoren & und |gebildet. Ein Beispiel ist "(&(objectClass=user)(lastName= Davis))". Ein weiteres Beispiel ist "(&(objectClass=printer)(|( building=42)(building=43))))".
Wenn der Filter ein Attribut des ADS_UTC_TIME-Typs enthält, muss sein Wert im Format yyyymmddhhmmssZ aufweisen, in denen y "," m "," d "," h "," m, und "s jeweils für Jahr, Monat, Tag, Stunde, minute und Sekunde, bzw. Der Sekundenwert (ss) ist optional. Der letzte Buchstabe Z bedeutet, dass es keine Zeitdifferenz gibt. In diesem Format wird "10:20:00 Uhr am 13. Mai 1999" zu "19990513102000Z". Beachten Sie, dass Active Directory Domain Services Datum und Uhrzeit als koordinierte Weltzeit (Greenwich Mean Time) speichert. Wenn Sie eine Zeit ohne Zeitdifferenz angeben, geben Sie die Uhrzeit in GMT-Zeit an.
Wenn Sie sich nicht in der koordinierten Weltzeitzone befinden, können Sie der koordinierten Weltzeit einen differenziellen Wert hinzufügen (anstatt Z anzugeben), um eine Zeit gemäß Ihrer Zeitzone anzugeben. Das Differenzial basiert auf folgendem: differenzielle = Koordinierte Weltzeit - Lokal. Verwenden Sie zum Angeben eines Differenzials das folgende Format: yyyyymmddhhhmmss[+/-]hhmm. Beispielsweise wird "23. März 1999" (20:52:58 Uhr, 23. März 1999) als "19990323205258.0+1200" angegeben.
Weitere Informationen zum LDAP-Suchzeichenfolgenformat finden Sie unter Search Filtersyntax.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für