DirectorySearcher.AttributeScopeQuery Свойство

Определение

Пространство имен:
System.DirectoryServices
Сборка:
System.DirectoryServices.dll
Пакет:
System.DirectoryServices v11.0.0-preview.3.26207.106
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs

Возвращает или задает отображаемое имя LDAP атрибута различающегося имени для поиска. Для этого типа поиска можно использовать только один атрибут.

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

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

String

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

Атрибуты
TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Исключения

ArgumentException

Свойство SearchScope имеет значение, отличное от Baseзначения.

Примеры

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

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. Атрибут может быть одним или несколькими значениями. Дополнительные сведения см. в статьях "Член " и " Управляемые по ".

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

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

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

Применяется к