Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DirectorySearcher.AttributeScopeQuery-Eigenschaft
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.
Assembly: System.DirectoryServices (in System.DirectoryServices.dll)
[ComVisibleAttribute(false)] [DSDescriptionAttribute("DSAttributeQuery")] [TypeConverterAttribute("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")] public string AttributeScopeQuery { get; set; }
Eigenschaftswert
Typ: System.StringDer LDAP-Anzeigename des Attributs, für das die Suche ausgeführt werden soll, oder eine leere Zeichenfolge, wenn keine Attributbereichsabfrage festgelegt ist.
| Ausnahme | Bedingung |
|---|---|
| ArgumentException |
Die SearchScope-Eigenschaft wird auf einen anderen Wert als Base festgelegt. |
Das Attribut, auf das diese Eigenschaft festgelegt ist, muss ein Attribut für einen Distinguished Name sein, z. B. member oder managedBy. Das Attribut kann entweder einen oder mehrere Werte enthalten. Weitere Informationen finden Sie in den Themen zu adschema unter "Member" und "Managed-By" in der MSDN Library unter http://msdn.microsoft.com/de-de/library/default.aspx.
Die Suche wird für Objekte ausgeführt, die durch den im Attribut des Basisobjekts angegebenen Distinguished Name identifiziert werden. Ist das Basisobjekt z. B. eine adschema-Gruppenklasse, und die AttributeScopeQuery ist auf "member" festgelegt, wird die Suche für alle Objekte ausgeführt, die Member dieser Gruppe sind. Weitere Informationen finden Sie in den Themen zum Active Directory-Schema unter dem Thema "Group" in der MSDN Library unter http://msdn.microsoft.com/de-de/library/default.aspx (nur auf Englisch verfügbar).
Wenn die AttributeScopeQuery-Eigenschaft verwendet wird, muss die SearchScope-Eigenschaft auf Base festgelegt werden. Wenn die SearchScope-Eigenschaft auf einen anderen Wert festgelegt wird, löst das Festlegen der AttributeScopeQuery-Eigenschaft eine ArgumentException aus.
Weitere Informationen finden Sie im Thema "Performing an Attribute Scope Query" in der MSDN Library unter http://msdn.microsoft.com/de-de/library/default.aspx (nur auf Englisch verfügbar).
Im folgenden Beispiel wird die Verwendung der AttributeScopeQuery-Eigenschaft mit dem Member-Attribut zum Abrufen der Mitglieder einer Gruppe veranschaulicht. Anschließend werden die Vor- und Nachnamen der Mitglieder sowie ihre Rufnummern ausgedruckt.
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("…"); }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
