DirectorySearcher.AttributeScopeQuery Vlastnost

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

DirectorySearcher.cs

Získá nebo nastaví zobrazovaný název LDAP rozlišující název atribut hledat v. 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 LDAP atributu, u který se má provést vyhledávání, nebo je nastaven prázdný řetězec dotazu bez oboru atributů.

Výjimky

ArgumentException

Vlastnost SearchScope je nastavená na jinou hodnotu než Base.

Příklady

Následující příklad ukazuje, jak použít AttributeScopeQuery vlastnost s atributem member k získání členů skupiny. Potom vypíše křestní jména 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 atribut rozlišujícího názvu, například member nebo managedBy. Atribut může mít jednu nebo vícehodnotovou hodnotu. Další informace najdete v článcích Člen a Spravováno .

Vyhledávání se provádí u objektů, které jsou identifikovány rozlišujícím názvem, který je zadán v atributu základního objektu. Pokud je například základní objekt třídou skupiny adschema a AttributeScopeQuery je nastaven na "member", bude vyhledávání provedeno pro všechny objekty, které jsou členy skupiny. Další informace najdete v článku Třída skupiny .

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

Další informace najdete v tématu Provádění dotazu na obor atributů.