Lesen von Eigenschaften für Verzeichnisobjekte

Beim Abrufen von Eigenschaften für ein Objekt werden die Daten als aufzählbare Auflistung zurückgegeben, auch wenn nur ein einziger Wert zurückgegeben wird. Diese Operation wird mit Properties ausgeführt. Dabei handelt es sich um eine Eigenschaft in der DirectoryEntry-Klasse. Properties gibt ein PropertyCollection-Objekt zurück. Die Werte der Eigenschaften, auf die in PropertyCollection verwiesen wird, werden im PropertyValueCollection-Objekt gespeichert.

Hinweis:
Die Verwendung der Properties-Eigenschaft mit der Active Directory-Clienterweiterung (DSClient) für Windows NT 4.0 wird nicht unterstützt.

Die Eigenschaftenwerte in einer Auflistung werden mithilfe der Value-Eigenschaft des PropertyValueCollection-Objekts gelesen. Wenn nur ein Wert in der Auflistung enthalten ist, wird dieser als Objektdarstellung des Werts zurückgegeben.

Geben Sie für den Zugriff auf den Wert einer Objekteigenschaft den Namen der Eigenschaft mit der im folgenden Codebeispiel gezeigten Syntax an.

DirectoryEntry.Properties("givenName").Value

DirectoryEntry.Properties["givenName"].Value;

In diesem Beispiel greift der Code auf die givenName-Eigenschaft zu. Dabei handelt es sich um den LDAP-Anzeigenamen für eine Eigenschaft eines Benutzerobjekts in den Active Directory-Domänendiensten und anderen LDAP-Verzeichnissen. Geben Sie für den Zugriff auf eine bestimmte Eigenschaft im Verzeichnis in der Anwendung den LDAP-Anzeigenamen für die betreffende Eigenschaft an. Weitere Informationen zur givenName-Eigenschaft und zum Active Directory-Benutzerobjekt finden Sie in den Themen givenName und User in der MSDN Library unter https://go.microsoft.com/fwlink/?LinkID=27252 (möglicherweise in englischer Sprache).

Im folgenden Codebeispiel wird die Verwendung der Properties-Auflistung zum Lesen eines einzelnen Werts veranschaulicht.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
Dim name As [string] = ent.Properties("sn").Value.ToString()
Console.WriteLine(name)

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
string name = ent.Properties["sn"].Value.ToString();
Console.WriteLine(name);

Siehe auch

Referenz

System.DirectoryServices
DirectoryEntry
PropertyCollection
PropertyValueCollection

Konzepte

Verzeichnisobjekteigenschaften

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Alle Rechte vorbehalten.