Compartir a través de


DirectorySearcher.AttributeScopeQuery Propiedad

Definición

Obtiene o establece el nombre LDAP para mostrar que corresponde al atributo de nombre distintivo en el que se va a realizar la búsqueda. Solo se puede utilizar un atributo para este tipo de búsqueda.

public:
 property System::String ^ AttributeScopeQuery { System::String ^ get(); void set(System::String ^ value); };
public string AttributeScopeQuery { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.DirectoryServices.DSDescription("DSAttributeQuery")]
[System.Runtime.InteropServices.ComVisible(false)]
public string AttributeScopeQuery { get; set; }
[System.DirectoryServices.DSDescription("DSAttributeQuery")]
[System.Runtime.InteropServices.ComVisible(false)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string AttributeScopeQuery { get; set; }
member this.AttributeScopeQuery : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.DirectoryServices.DSDescription("DSAttributeQuery")>]
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.AttributeScopeQuery : string with get, set
[<System.DirectoryServices.DSDescription("DSAttributeQuery")>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.AttributeScopeQuery : string with get, set
Public Property AttributeScopeQuery As String

Valor de propiedad

Se establece el nombre LDAP para mostrar correspondiente al atributo con el que se va a realizar la búsqueda o una cadena vacía que indica que no hay ninguna consulta de ámbito de atributo.

Atributos

Excepciones

La propiedad SearchScope se establece en un valor distinto de Base.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la AttributeScopeQuery propiedad con el atributo member para obtener los miembros de un grupo. A continuación, imprime los nombres y apellidos de los miembros y sus números de teléfono.

using System;
using System.DirectoryServices;  

public class Example
{
    public static void Main()
    {
        DirectoryEntry group = new DirectoryEntry("LDAP://CN=MyGroup", …);        
        DirectorySearcher src = new DirectorySearcher("(&(objectClass=user)(objectCategory=Person))");      
        src.SearchRoot = group;
        src.AttributeScopeQuery = "member";  
        src.PropertiesToLoad.Add("sn");
        src.PropertiesToLoad.Add("givenName");  
        src.PropertiesToLoad.Add("telephoneNumber");  

        foreach(SearchResult res in src.FindAll())  
        {  
            Console.WriteLine("…");  
        }
    }
}

Comentarios

El atributo en el que se establece esta propiedad debe ser un atributo de nombre distintivo, como miembro o managedBy. El atributo puede ser de uno o varios valores. Para obtener más información, consulte los artículos Miembro y Administrado por .

La búsqueda se realiza en los objetos identificados por el nombre distintivo especificado en el atributo del objeto base. Por ejemplo, si el objeto base es una clase de grupo adschema y AttributeScopeQuery se establece en "miembro", la búsqueda se realizará en todos los objetos que son miembros del grupo. Para obtener más información, consulte el artículo Clase de grupo .

Cuando se usa la AttributeScopeQuery propiedad , la SearchScope propiedad debe establecerse en Base. Si la SearchScope propiedad se establece en cualquier otro valor, al establecer la AttributeScopeQuery propiedad se producirá una ArgumentExceptionexcepción .

Para obtener más información, consulte La consulta De ámbito de atributo.

Se aplica a