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 instrucciones siguientes:

  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, y s se describen 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 hora como hora universal coordinada (hora media de Greenwich). Si especifica una hora sin diferencial de tiempo, especifica 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 (el diferencial 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 Búsqueda sintaxis de filtro.

Se aplica a