DirectorySearcher.AttributeScopeQuery Właściwość

Definicja

Przestrzeń nazw:

System.DirectoryServices

Zestaw:

System.DirectoryServices.dll

Pakiet:

System.DirectoryServices v8.0.0

Źródło:

DirectorySearcher.cs

Pobiera lub ustawia nazwę wyświetlaną LDAP atrybutu nazwy wyróżniającej do wyszukania. Dla tego typu wyszukiwania można używać tylko jednego atrybutu.

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

Wartość właściwości

String

Nazwa wyświetlana LDAP atrybutu do wykonania wyszukiwania lub pusty ciąg bez kwerendy zakresu atrybutu jest ustawiony.

Wyjątki

ArgumentException

Właściwość jest ustawiona SearchScope na wartość inną niż Base.

Przykłady

W poniższym przykładzie pokazano, jak używać AttributeScopeQuery właściwości z atrybutem elementu członkowskiego w celu pobrania członków grupy. Następnie drukuje imię i nazwisko członków i ich numerów telefonów.

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

Uwagi

Atrybut, dla którego ustawiono tę właściwość, musi być atrybutem nazwy wyróżniającej, takim jak element członkowski lub zarządzanyBy. Atrybut może być pojedynczy lub wielowarty. Aby uzyskać więcej informacji, zobacz artykuły Member and Managed-By (Członek i Zarządzane według).

Wyszukiwanie jest wykonywane względem obiektów, które są identyfikowane przez nazwę wyróżniającą określoną w atrybucie obiektu podstawowego. Jeśli na przykład obiekt podstawowy jest klasą grupy adschema i AttributeScopeQuery jest ustawiona na "składową", wyszukiwanie zostanie wykonane względem wszystkich obiektów będących członkami grupy. Aby uzyskać więcej informacji, zobacz artykuł Group class (Klasa grupy ).

AttributeScopeQuery Gdy właściwość jest używana, właściwość musi być ustawiona SearchScope na Base. Jeśli właściwość jest ustawiona SearchScope na dowolną inną wartość, ustawienie AttributeScopeQuery właściwości spowoduje wyrzucenie ArgumentExceptionwartości .

Aby uzyskać więcej informacji, zobacz Wykonywanie zapytania zakresu atrybutu.