DirectorySearcher.AttributeScopeQuery Свойство

Ссылка

Определение

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

Сборка:: System.DirectoryServices.dll

Пакет:: System.DirectoryServices v6.0.0

Пакет:: System.DirectoryServices v7.0.0

Пакет:: System.DirectoryServices v8.0.0

Пакет:: System.DirectoryServices v9.0.0-preview.2.24128.5

Исходный код:: 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 свойство с атрибутом 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исключение .

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

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

Поделиться через