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.Gets or sets the LDAP display name of the distinguished name attribute to search in. Solo se puede utilizar un atributo para este tipo de búsqueda.Only one attribute can be used for this type of search.

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

String

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.The LDAP display name of the attribute to perform the search against, or an empty string of no attribute scope query is set.

Atributos

Excepciones

La propiedad SearchScope se establece en un valor distinto de Base.The SearchScope property is set to a value other than Base.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar la AttributeScopeQuery propiedad con el atributo Member para obtener los miembros de un grupo.The following example shows how to use the AttributeScopeQuery property with the member attribute to get the members of a group. A continuación, imprime el nombre y los apellidos de los miembros y sus números de teléfono.It then prints out the first and last names of the members and their telephone numbers.

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.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 Member o managedBy.The attribute that this property is set to must be a distinguished name attribute, such as member or managedBy. El atributo puede ser uno o varios valores.The attribute can be either single or multi-valued. Para obtener más información, consulte los artículos sobre miembros y administrados por .For more information, see the Member and Managed-By articles.

La búsqueda se realiza en los objetos identificados por el nombre distintivo que se especifica en el atributo del objeto base.The search is performed against the objects that are identified by the distinguished name that is specified in the attribute of the base object. Por ejemplo, si el objeto base es una clase de grupo adschema y el AttributeScopeQuery valor de está establecido en "Member", la búsqueda se realizará en todos los objetos que son miembros del grupo.For example, if the base object is an adschema group class and the AttributeScopeQuery is set to "member," then the search will be performed against all objects that are members of the group. Para obtener más información, consulte el artículo sobre clases de grupos .For more information, see the Group class article.

Cuando AttributeScopeQuery se utiliza la propiedad, la SearchScope propiedad debe establecerse en Base .When the AttributeScopeQuery property is used, the SearchScope property must be set to Base. Si la SearchScope propiedad se establece en cualquier otro valor, al establecer la AttributeScopeQuery propiedad se producirá una excepción ArgumentException .If the SearchScope property is set to any other value, setting the AttributeScopeQuery property will throw an ArgumentException.

Para obtener más información, consulte la consulta realizar un ámbito de atributo.For more information, see the Performing an Attribute Scope Query.

Se aplica a