DirectorySearcher.Filter Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.DirectoryServices
Zestaw:
System.DirectoryServices.dll
Pakiet:
System.DirectoryServices v6.0.0
Pakiet:
System.DirectoryServices v7.0.0
Pakiet:
System.DirectoryServices v8.0.0
Pakiet:
System.DirectoryServices v9.0.0-preview.2.24128.5
Źródło:
DirectorySearcher.cs
Źródło:
DirectorySearcher.cs
Źródło:
DirectorySearcher.cs

Pobiera lub ustawia wartość wskazującą ciąg filtru formatu Lightweight Directory Access Protocol (LDAP).

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

Wartość właściwości

String

Ciąg filtru wyszukiwania w formacie LDAP, taki jak "(objectClass=user)". Wartość domyślna to "(objectClass=*)", która pobiera wszystkie obiekty.

Atrybuty
TypeConverterAttribute DSDescriptionAttribute SettingsBindableAttribute

Uwagi

Filtr używa następujących wskazówek:

  1. Ciąg musi być ujęta w nawiasy.

  2. Wyrażenia mogą używać operatorów relacyjnych: <, <=, =, =, >= i >. Przykładem jest "(objectClass=user)". Innym przykładem jest "(lastName>=Davis)".

  3. Wyrażenia złożone są tworzone z operatorami prefiksów & i |. Przykładem jest "(&(objectClass=user)(lastName= Davis))". Innym przykładem jest "(&(objectClass=printer)(|( building=42)(building=43))".

Gdy filtr zawiera atrybut typu ADS_UTC_TIME, jego wartość musi być odpowiednio formatem rrrrmddhhmmssZ, gdzie y, m, d, h, m, m i s stoją odpowiednio w roku, miesiąc, dzień, godzina, minuta i sekunda. Wartość sekund (ss) jest opcjonalna. Ostatnia litera Z oznacza, że nie ma różnicy czasu. W tym formacie "10:20:00 rano 13 maja 1999" staje się "19990513102000Z". Należy pamiętać, że Active Directory Domain Services przechowuje datę i godzinę jako uniwersalny czas koordynowany (Czas średni Greenwich). Jeśli określisz godzinę bez różnicy czasu, określasz godzinę w czasie GMT.

Jeśli nie jesteś w uniwersalnej strefie czasowej koordynowanej, możesz dodać wartość różnicową do uniwersalnego czasu koordynowanego (zamiast określania Z), aby określić czas zgodnie ze strefą czasową. Różnicowa jest oparta na następujących: różnicowa = uniwersalny czas koordynowany — lokalny. Aby określić różnicowy, użyj następującego formatu: rrrrrrddhmmss[+/-]hhmm. Na przykład "23 marca 23 marca 1999 r. "8:52:58" Nowa Zelandia (różnica wynosi 12 godzin) jest określona jako "19990323205258.0+1200".

Aby uzyskać więcej informacji na temat formatu ciągu wyszukiwania LDAP, zobacz Search Składnia filtru.

Dotyczy