DirectorySearcher.AttributeScopeQuery DirectorySearcher.AttributeScopeQuery DirectorySearcher.AttributeScopeQuery DirectorySearcher.AttributeScopeQuery Property

Definition

Ruft den LDAP-Anzeigenamen des Attributs für den Distinguished Name auf, in dem gesucht werden soll, oder legt diesen fest. Gets or sets the LDAP display name of the distinguished name attribute to search in. Für diesen Suchtyp kann nur ein Attribut verwendet werden. Only one attribute can be used for this type of search.

public:
 property System::String ^ AttributeScopeQuery { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.DirectoryServices.DSDescription("DSAttributeQuery")]
[System.Runtime.InteropServices.ComVisible(false)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string AttributeScopeQuery { get; set; }
member this.AttributeScopeQuery : string with get, set
Public Property AttributeScopeQuery As String

Property Value

Der LDAP-Anzeigename des Attributs, für das die Suche ausgeführt werden soll, oder eine leere Zeichenfolge, wenn keine Attributbereichsabfrage festgelegt ist. The LDAP display name of the attribute to perform the search against, or an empty string of no attribute scope query is set.

Exceptions

Die SearchScope-Eigenschaft wird auf einen anderen Wert als Base festgelegt. The SearchScope property is set to a value other than Base.

Examples

Das folgende Beispiel zeigt, wie Sie mit der AttributeScopeQuery Eigenschaft mit dem das Member-Attribut zum Abrufen der Mitglieder einer Gruppe.The following example shows how to use the AttributeScopeQuery property with the member attribute to get the members of a group. Klicken Sie dann die vor- und Nachnamen-Namen, der die Elemente und ihre Telefonnummern ausgegeben.It then prints out the first and last names of the members and their telephone numbers.

using System.DirectoryServices;  
DirectoryEntry group = new DirectoryEntry("LDAP://CN=MyGroup, …");  
DirectorySearcher src = new DirectorySearcher(group "(&(objectClass=user)(objectCategory=Person))");  
src.AttributeScopedQuery = "member";  
src.PropertiesToLoad.Add("sn");  
src.PropertiesToLoad.Add("givenName");  
src.PropertiesToLoad.Add("telephoneNumber");  
foreach(SearchResult res in src.FindAll())  
{  
    Console.WriteLine("…");  
}  

Remarks

Das Attribut, das diese Eigenschaft auf festgelegt ist, muss ein distinguished Name-Attribut, wie Member oder ManagedBy sein.The attribute that this property is set to must be a distinguished name attribute, such as member or managedBy. Das Attribut kann entweder ein- oder mehrwertige sein.The attribute can be either single or multi-valued. Weitere Informationen finden Sie unter den Themen zu Adschema "Member"und"Managed By" in der MSDN Library unter http://msdn.microsoft.com/library .For more information, see the adschema topics "Member" and "Managed-By" in the MSDN Library at http://msdn.microsoft.com/library.

Die Suche erfolgt anhand der Objekte, die durch den distinguished Name, die im Attribut des Basisobjekts angegeben wird, identifiziert werden.The search is performed against the objects that are identified by the distinguished name that is specified in the attribute of the base object. Beispielsweise ist das Basisobjekt eine Adschema Gruppe-Klasse und die AttributeScopeQuery nastaven NA hodnotu "Member", und klicken Sie dann die Suche für alle Objekte ausgeführt wird, die Mitglieder der Gruppe sind.For example, if the base object is an adschema group class and the AttributeScopeQuery is set to "member," then the search will be performed against all objects that are members of the group. Weitere Informationen finden Sie im Thema Adschema "Group"-Klasse, in der MSDN Library unter http://msdn.microsoft.com/library .For more information, see the adschema "Group" class topic in the MSDN Library at http://msdn.microsoft.com/library.

Wenn die AttributeScopeQuery Eigenschaft wird verwendet, die SearchScope Eigenschaft muss festgelegt werden, um Base.When the AttributeScopeQuery property is used, the SearchScope property must be set to Base. Wenn die SearchScope -Eigenschaftensatz auf einem anderen Wert festlegen die AttributeScopeQuery Eigenschaft löst eine ArgumentException.If the SearchScope property is set to any other value, setting the AttributeScopeQuery property will throw an ArgumentException.

Weitere Informationen finden Sie im Thema "Ausführen einer Attribute Scope-Query" in der MSDN Library unter http://msdn.microsoft.com/library ).For more information, see the "Performing an Attribute Scope Query" topic in the MSDN Library at http://msdn.microsoft.com/library).

Applies to