DirectorySearcher.AttributeScopeQuery Propriedade

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacote:

System.DirectoryServices v8.0.0

Origem:

DirectorySearcher.cs

Obtém ou define o nome de exibição LDAP do atributo de nome diferenciado a ser pesquisado. Somente um atributo pode ser usado para esse tipo de pesquisa.

public:
 property System::String ^ AttributeScopeQuery { System::String ^ get(); void set(System::String ^ value); };

public string AttributeScopeQuery { get; set; }

member this.AttributeScopeQuery : string with get, set

Public Property AttributeScopeQuery As String

Valor da propriedade

String

O nome de exibição LDAP do atributo que será pesquisado ou uma cadeia de caracteres vazia sem qualquer consulta de escopo de atributo é definida.

Exceções

ArgumentException

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

Exemplos

O exemplo a seguir mostra como usar a AttributeScopeQuery propriedade com o atributo membro para obter os membros de um grupo. Em seguida, imprime os primeiros e sobrenomes dos membros e 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("…");  
        }
    }
}

Comentários

O atributo para o qual essa propriedade está definida deve ser um atributo de nome diferenciado, como member ou managedBy. O atributo pode ser individual ou com vários valores. Para obter mais informações, consulte os artigos Membro e Gerenciado por .

A pesquisa é executada nos objetos identificados pelo nome diferenciado especificado no atributo do objeto base. Por exemplo, se o objeto base for uma classe de grupo adschema e o AttributeScopeQuery for definido como "membro", a pesquisa será executada em todos os objetos que são membros do grupo. Para obter mais informações, consulte o artigo Classe de grupo.

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

Para obter mais informações, consulte a consulta Executando um escopo de atributo.