DirectorySearcher.Filter Propiedad

  • Referencia

Definición

Espacio de nombres:
System.DirectoryServices
Ensamblado:
System.DirectoryServices.dll
Paquete:
System.DirectoryServices v6.0.0
Paquete:
System.DirectoryServices v7.0.0
Paquete:
System.DirectoryServices v8.0.0
Paquete:
System.DirectoryServices v9.0.0-preview.2.24128.5
Source:
DirectorySearcher.cs
Source:
DirectorySearcher.cs
Source:
DirectorySearcher.cs

Obtiene o establece un valor que indica la cadena de filtro en formato de Protocolo ligero de acceso a directorios (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

Valor de propiedad

String

Cadena de filtro de búsqueda en formato LDAP, como "(objectClass=user)". El valor predeterminado es "(objectClass=*)", que recupera todos los objetos.

Atributos
TypeConverterAttribute DSDescriptionAttribute SettingsBindableAttribute

Comentarios

El filtro usa las siguientes directrices:

  1. La cadena debe ir entre paréntesis.

  2. Las expresiones pueden usar los operadores relacionales: <, <=, =, =, >= y >. Un ejemplo es "(objectClass=user)". Otro ejemplo es "(lastName>=Davis)".

  3. Las expresiones compuestas se forman con los operadores de prefijo & y |. Un ejemplo es "(&(objectClass=user)(lastName= Davis))". Otro ejemplo es "(&(objectClass=printer)(|( building=42)(building=43)))".

Cuando el filtro contiene un atributo de ADS_UTC_TIME tipo, su valor debe ser del formato aaaammddhhmmssZ, donde y, m, d, h, m, m, y s son para year, month, day, hour, minute y second, respectivamente. El valor de segundos (ss) es opcional. La letra final Z significa que no hay ningún diferencial de tiempo. En este formato, "10:20:00 A.M. 13 de mayo de 1999" se convierte en "19990513102000Z". Tenga en cuenta que Servicios de dominio de Active Directory almacena la fecha y la hora como hora universal coordinada (hora media de Greenwich). Si especifica una hora sin diferencial de tiempo, va a especificar la hora en hora GMT.

Si no está en la zona horaria universal coordinada, puede agregar un valor diferencial a la hora universal coordinada (en lugar de especificar Z) para especificar una hora según la zona horaria. El diferencial se basa en lo siguiente: diferencial = Hora universal coordinada: local. Para especificar un diferencial, use el siguiente formato: aaaammddhhmmss[+/-]hhmm. Por ejemplo, "8:52:58 P.M. 23 de marzo de 1999" Hora estándar de Nueva Zelanda (la diferencia es de 12 horas) se especifica como "19990323205258.0+1200".

Para obtener más información sobre el formato de cadena de búsqueda LDAP, vea Sintaxis de filtro de búsqueda.

Se aplica a