DirectorySearcher.AttributeScopeQuery Свойство

Определение

Пространство имен:

System.DirectoryServices

Сборка:

System.DirectoryServices.dll

Пакет:

System.DirectoryServices v8.0.0

Исходный код:

DirectorySearcher.cs

Получает или задает отображаемое имя LDAP атрибута отличительного имени для поиска. Только один атрибут может использоваться для поиска данного типа.

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

Значение свойства

String

Отображаемое имя LDAP атрибута для выполнения поиска или пустая строка, означающая, что запрос области атрибута не задан.

Исключения

ArgumentException

Для свойства SearchScope задано значение, отличающееся от Base.

Примеры

В следующем примере показано, как использовать AttributeScopeQuery свойство с атрибутом member для получения членов группы. Затем он выводит имена и фамилии членов и их номера телефонов.

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

Комментарии

Атрибут, для которого задано это свойство, должен быть атрибутом различающегося имени, например member или managedBy. Атрибут может быть однозначным или многозначным. Дополнительные сведения см. в статьях Member и Managed-By .

Поиск выполняется по объектам, которые идентифицируются по различаемом имени, указанному в атрибуте базового объекта. Например, если базовый объект является классом группы adschema, а AttributeScopeQuery для задано значение "member", поиск будет выполнен для всех объектов, которые являются членами группы. Дополнительные сведения см. в статье Класс Group .

AttributeScopeQuery При использовании SearchScope свойства необходимо задать для свойства значение Base. Если свойству SearchScope присвоено любое другое значение, задание AttributeScopeQuery свойства вызовет ArgumentExceptionисключение .

Дополнительные сведения см. в разделе Выполнение запроса области атрибута.