DirectorySearcher.Filter Propriedade

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

Valor da propriedade

A cadeia de caracteres de filtro de pesquisa no formato LDAP, como "(objectClass=user)". O padrão é "(objectClass=*)", que recupera todos os objetos.

Atributos

TypeConverterAttribute DSDescriptionAttribute SettingsBindableAttribute

Comentários

O filtro usa as seguintes diretrizes:

1. A cadeia de caracteres deve estar entre parênteses.

2. As expressões podem usar os operadores relacionais: <, <=, =, >=, e >. Um exemplo é "(objectClass=user)". Outro exemplo é "(lastName>=Davis)".

3. Expressões compostas são formadas com os operadores de prefixo & e |. Um exemplo é "(&(objectClass=user)(lastName= Davis))". Outro exemplo é "(&(objectClass=printer)(|( building=42)(building=43)))".

Quando o filtro contém um atributo de ADS_UTC_TIME tipo, seu valor deve ser do formato yyyymmddhhmmssZ em que y, m, d, h, m e s se posicionam para o ano, mês, dia, hora, minuto e segundo, respectivamente. O valor de segundos (ss) é opcional. A letra final Z significa que não há diferencial de tempo. Nesse formato, "10:20:00 A.M. May 13, 1999" torna-se "19990513102000Z". Observe que Active Directory Domain Services armazena data e hora como Tempo Universal Coordenado (Horário de Greenwich). Se você especificar um horário sem diferencial de tempo, especifica a hora no horário GMT.

Se você não estiver no fuso horário Universal Coordenado, poderá adicionar um valor diferencial ao Tempo Universal Coordenado (em vez de especificar Z) para especificar uma hora de acordo com seu fuso horário. O diferencial é baseado no seguinte: diferencial = Tempo Universal Coordenado - Local. Para especificar um diferencial, use o seguinte formato: yyyymmddhhmmss[+/-]hhmm. Por exemplo, "8:52:58 P.M. March 23, 1999" New Zealand Standard Time (o diferencial é 12 horas) é especificado como "19990323205258.0+1200".

Para obter mais informações sobre o formato de cadeia de caracteres de pesquisa LDAP, consulte Sintaxe de filtro de pesquisa.

Aplica-se a