DirectorySearcher.Filter Eigenschaft

  • Referenz

Definition

Namespace:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll
Paket:
System.DirectoryServices v6.0.0
Paket:
System.DirectoryServices v7.0.0
Paket:
System.DirectoryServices v8.0.0
Paket:
System.DirectoryServices v9.0.0-preview.2.24128.5
Quelle:
DirectorySearcher.cs
Quelle:
DirectorySearcher.cs
Quelle:
DirectorySearcher.cs

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

String

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

Attribute
TypeConverterAttribute DSDescriptionAttribute SettingsBindableAttribute

Hinweise

Der Filter verwendet die folgenden Richtlinien:

  1. Die Zeichenfolge muss in Klammern eingeschlossen werden.

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

  3. 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: