Freigeben über


DirectorySearcher.AttributeScopeQuery Eigenschaft

Definition

Ruft den LDAP-Anzeigenamen des Attributs für den Distinguished Name auf, in dem gesucht werden soll, oder legt diesen fest. Für diesen Suchtyp kann nur ein Attribut verwendet werden.

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

Eigenschaftswert

Der LDAP-Anzeigename des Attributs, für das die Suche ausgeführt werden soll, oder eine leere Zeichenfolge, wenn keine Attributbereichsabfrage festgelegt ist.

Attribute

Ausnahmen

Die SearchScope-Eigenschaft wird auf einen anderen Wert als Base festgelegt.

Beispiele

Das folgende Beispiel zeigt, wie die AttributeScopeQuery -Eigenschaft mit dem Member-Attribut verwendet wird, um die Mitglieder einer Gruppe abzurufen. Anschließend werden die Vor- und Nachnamen der Mitglieder und deren Telefonnummern gedruckt.

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

Hinweise

Das Attribut, auf das diese Eigenschaft festgelegt ist, muss ein Distinguished Name-Attribut sein, z. B. member oder managedBy. Das Attribut kann entweder ein- oder mehrwertig sein. Weitere Informationen finden Sie in den Artikeln Member und Managed-By .

Die Suche wird für die Objekte ausgeführt, die durch den distinguished name identifiziert werden, der im -Attribut des Basisobjekts angegeben ist. Wenn das Basisobjekt beispielsweise eine adschema-Gruppenklasse ist und auf AttributeScopeQuery "member" festgelegt ist, wird die Suche für alle Objekte ausgeführt, die Mitglieder der Gruppe sind. Weitere Informationen finden Sie im Artikel Zur Gruppenklasse .

Wenn die AttributeScopeQuery -Eigenschaft verwendet wird, muss die SearchScope -Eigenschaft auf Basefestgelegt werden. Wenn die SearchScope -Eigenschaft auf einen anderen Wert festgelegt ist, löst das Festlegen der AttributeScopeQuery -Eigenschaft einen aus ArgumentException.

Weitere Informationen finden Sie unter Ausführen einer Attributbereichsabfrage.

Gilt für: