DirectorySearcher.AttributeScopeQuery Eigenschaft

Referenz

Definition

Namespace:: System.DirectoryServices

Assembly:: System.DirectoryServices.dll

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 Sie die AttributeScopeQuery Eigenschaft mit dem Member-Attribut verwenden, um die Mitglieder einer Gruppe abzurufen. Anschließend werden die Vornamen 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.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 unterscheidungsgesteuertes Namensattribute sein, z. B. Member oder managedBy. Das Attribut kann entweder einzeln 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 unterschiedenen Namen identifiziert werden, der im Attribut des Basisobjekts angegeben ist. Wenn das Basisobjekt z. B. eine Adschema-Gruppenklasse ist und der AttributeScopeQuery auf "Member" festgelegt ist, wird die Suche für alle Objekte ausgeführt, die Mitglieder der Gruppe sind. Weitere Informationen finden Sie im Gruppenklassenartikel .

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 ArgumentException.

Weitere Informationen finden Sie unter "Ausführen einer Attributbereichsabfrage".

Gilt für