DirectorySearcher.AttributeScopeQuery Propiedad

Referencia

Definición

Espacio de nombres:: System.DirectoryServices

Ensamblado:: System.DirectoryServices.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

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.

Atributos: TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Excepciones

ArgumentException

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.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