DirectorySearcher.AttributeScopeQuery 属性

定义

命名空间:

System.DirectoryServices

程序集:

System.DirectoryServices.dll

包:

System.DirectoryServices v8.0.0

Source:

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 以外的一个值。

示例

以下示例演示如何将 属性与 member 属性一 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。 属性可以是单值或多值。 有关详细信息，请参阅 成员 和 Managed-By 文章。

对由基对象的 属性中指定的可分辨名称标识的对象执行搜索。 例如，如果基对象是 adschema 组类，并且 AttributeScopeQuery 设置为“member”，则将针对属于组成员的所有对象执行搜索。 有关详细信息，请参阅 Group 类 一文。

AttributeScopeQuery使用 属性时， SearchScope 属性必须设置为 Base。 如果 属性 SearchScope 设置为任何其他值，则设置 属性 AttributeScopeQuery 将引发 ArgumentException。

有关详细信息，请参阅 执行属性范围查询。