DirectorySearcher.AttributeScopeQuery Vlastnost

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Zdroj:

DirectorySearcher.cs

Získá nebo nastaví zobrazovaný název LDAP atributu rozlišujícího názvu pro vyhledávání. Pro tento typ vyhledávání lze použít pouze jeden atribut.

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

Hodnota vlastnosti

String

Zobrazovaný název atributu LDAP, který se má prohledávat, nebo je nastaven prázdný řetězec dotazu oboru atributu.

Výjimky

ArgumentException

Vlastnost SearchScope je nastavena na jinou hodnotu než Base.

Příklady

Následující příklad ukazuje, jak použít AttributeScopeQuery vlastnost s atributem člen k získání členů skupiny. Potom vypíše křestní jméno a příjmení členů a jejich telefonní čísla.

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

Poznámky

Atribut, na který je tato vlastnost nastavena, musí být rozlišující název atribut, jako je člen nebo managedBy. Atribut může být buď jeden, nebo vícehodnotový. Další informace najdete v článcích Člen a Spravované podle .

Vyhledávání se provádí proti objektům, které jsou identifikovány rozlišujícím názvem zadaným v atributu základního objektu. Pokud je například základní objekt třídou skupiny adschema a AttributeScopeQuery je nastavena na "člen", bude vyhledávání provedeno proti všem objektům, které jsou členy skupiny. Další informace najdete v článku o třídě skupiny .

AttributeScopeQuery Při použití vlastnosti musí být vlastnost nastavena SearchScope na Basehodnotu . SearchScope Pokud je vlastnost nastavena na jakoukoli jinou hodnotu, nastavení AttributeScopeQuery vlastnosti vyvolá výjimku ArgumentException.

Další informace naleznete v tématu Provádění dotazu oboru atributů.