DirectorySearcher.AttributeScopeQuery Propriedade

Definição

Espaço de Nomes:
System.DirectoryServices
Assemblagem:
System.DirectoryServices.dll

Obtém ou define o nome de exibição LDAP do atributo do nome distinto para pesquisar. Apenas um atributo pode ser usado para este tipo de pesquisa.

public:
 property System::String ^ AttributeScopeQuery { System::String ^ get(); void set(System::String ^ value); };
[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; }
[<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 Propriedade

String

É definido o nome de exibição LDAP do atributo contra o qual realizar a pesquisa, ou uma sequência vazia de consulta sem escopo de atributo.

Atributos
TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Exceções

ArgumentException

A SearchScope propriedade é definida para um valor diferente de Base.

Exemplos

O exemplo seguinte mostra como usar a AttributeScopeQuery propriedade com o atributo membro para obter os membros de um grupo. Depois, imprime os primeiros e apelidos dos membros e os seus números de telefone.

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("…");
        }
    }
}

Observações

O atributo a que esta propriedade está definida deve ser um atributo de nome distinto, como member ou managedBy. O atributo pode ser único ou multivalorado. Para mais informações, consulte os artigos de Membros e Geridos Por .

A pesquisa é realizada pelos objetos identificados pelo nome distinto especificado no atributo do objeto base. Por exemplo, se o objeto base for uma classe de grupo adschema e o AttributeScopeQuery estiver definido como "member", então a pesquisa será realizada contra todos os objetos que são membros do grupo. Para mais informações, consulte o artigo da classe de Grupo .

Quando a AttributeScopeQuery propriedade é utilizada, ela SearchScope deve ser definida para Base. Se a SearchScope propriedade for definida para qualquer outro valor, definir a AttributeScopeQuery propriedade gerará um ArgumentException.

Para mais informações, consulte a Realização de uma Consulta de Escopo de Atributo.

Aplica-se a