DirectorySearcher.AttributeScopeQuery Eigenschaft

Referenz

Definition

Namespace:: System.DirectoryServices

Assembly:: System.DirectoryServices.dll

Paket:: System.DirectoryServices v6.0.0

Paket:: System.DirectoryServices v7.0.0

Paket:: System.DirectoryServices v8.0.0

Paket:: System.DirectoryServices v9.0.0-preview.2.24128.5

Quelle:: DirectorySearcher.cs

Quelle:: DirectorySearcher.cs

Quelle:: DirectorySearcher.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

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

Attribute: TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Ausnahmen

ArgumentException

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:

Freigeben über