Sdílet prostřednictvím

DirectorySearcher.Filter Vlastnost

  • Reference

Definice

Obor názvů:
System.DirectoryServices
Sestavení:
System.DirectoryServices.dll
Balíček:
System.DirectoryServices v6.0.0
Balíček:
System.DirectoryServices v7.0.0
Balíček:
System.DirectoryServices v8.0.0
Balíček:
System.DirectoryServices v9.0.0-preview.2.24128.5
Zdroj:
DirectorySearcher.cs
Zdroj:
DirectorySearcher.cs
Zdroj:
DirectorySearcher.cs

Získá nebo nastaví hodnotu označující řetězec filtru formátu Ldap (Lightweight Directory Access Protocol).

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

Hodnota vlastnosti

String

Řetězec vyhledávacího filtru ve formátu LDAP, například "(objectClass=user)". Výchozí hodnota je "(objectClass=*)", která načte všechny objekty.

Atributy
TypeConverterAttribute DSDescriptionAttribute SettingsBindableAttribute

Poznámky

Filtr používá následující pokyny:

  1. Řetězec musí být uzavřený v závorkách.

  2. Výrazy můžou používat relační operátory: <, <=, =, >=, a >. Příkladem je "(objectClass=user)". Dalším příkladem je "(příjmení>=Davis)".

  3. Složené výrazy jsou tvořeny operátory předpony & a |. Příkladem je "(&(objectClass=user)(lastName= Davis)". Dalším příkladem je "(&(objectClass=printer)(|( building=42)(building=43)))".

Pokud filtr obsahuje atribut typu ADS_UTC_TIME, jeho hodnota musí být ve formátu rrrrmmddhhmmssZ, kde y, m, d, h, m a s představuje rok, měsíc, den, hodinu, minutu a sekundu. Hodnota sekund (ss) je volitelná. Poslední písmeno Z znamená, že neexistuje žádný časový rozdíl. V tomto formátu se "10:20:00 A.M. 13, 19999" stane "19990513102000Z". Všimněte si, že Active Directory Domain Services ukládá datum a čas jako koordinovaný univerzální čas (Greenwich mean time). Pokud zadáte čas bez časového rozdílu, zadáte čas v čase GMT.

Pokud nejste v koordinovaném časovém pásmu univerzálního času, můžete do koordinovaného univerzálního času přidat rozdílovou hodnotu (místo zadání Z) a určit čas podle vašeho časového pásma. Rozdíl je založen na následujícím: differential = Coordinated Universal Time- Local. Pokud chcete určit rozdílový, použijte následující formát: rrrrmmddhhmmss[+/-]hhmm. Například "23. března 1999" Nový Zéland (rozdíl je 12 hodin) je zadaný jako "19990323205258.0+1200".

Další informace o formátu vyhledávacího řetězce LDAP najdete v tématu syntaxe filtru Search.

Platí pro