DirectoryEntry-Objekte

In System.DirectoryServices werden alle Objekte im Verzeichnis durch das DirectoryEntry-Objekt dargestellt. DirectoryEntry erstellt ein Eintragsobjekt im Speicher. Das eigentliche Objekt im Verzeichnis wird erst beim Aufruf der CommitChanges-Methode erstellt. Der Vorteil dieser Vorgehensweise besteht darin, dass Verzeichnisinformationen für den Zugriff einer Clientanwendung abgerufen und diese Informationen lokal gelesen oder geändert werden können, bevor erneut eine Verbindung zum Server hergestellt wird, um die geänderten Informationen zu speichern. Dadurch wird die Servereffizienz optimiert.

Jede Netzressource wird im Verzeichnis als Objekt dargestellt, und jedes Verzeichnisobjekt wird wie bereits erwähnt in der Clientanwendung als DirectoryEntry dargestellt.

DirectoryEntry-Objekte weisen die folgenden Merkmale auf:

• Name: Der Objektname wird auch als relativer definierter Name (RDN) bezeichnet. Das Format für den RDN verwendet die Syntax Schlüssel=Wert. Im folgenden Diagramm lautet der RDN für ein Benutzerobjekt beispielsweise CN=Jeff Smith. Beachten Sie die enthaltenen Leerzeichen.
• Parent: Netzobjekte sind hierarchisch und verfügen über ein übergeordnetes Objekt, bis das Stammobjekt erreicht wird. Beim Stammobjekt handelt es sich um das Domänenobjekt am Anfang der Hierarchie, das bisweilen auch Domänenkopf genannt wird.
• Path: Der Verzeichnisobjektpfad wird auch als definierter Name (DN) bezeichnet. Der definierte Name besteht aus dem Objektnamen, dem die Namen der einzelnen übergeordneten Objekte bis zum Stammobjekt voranstehen. Für das Benutzerobjekt CN=Jeff Smith beginnt der DN mit dem Stammobjekt. Dahinter folgt der Pfad zum Benutzerobjekt, z. B.: DC=Fabrikam,DC=COM,OU=Sales,CN=Jeff Smith. Die Pfade verwenden eine Syntax gemäß Definition in der LDAP-Spezifikation. Weitere Informationen zur richtigen Syntax für den Pfad finden Sie unter Binden von Zeichenfolgen. Der Pfad wird in einer Bindungszeichenfolge verwendet, die mit dem DirectoryEntry-Objekt erstellt wird.

Die obigen Informationen gelten für alle LDAP-Verzeichnisobjekte, zu denen mit System.DirectoryServices eine Verbindung hergestellt wird. Für die Active Directory-Domänendienste gibt es jedoch einige Besonderheiten. Objekte der Active Directory-Domänendienste müssen beispielsweise eine GUID (Globally Unique Identifier) enthalten. Während die Werte für die verschiedenen Attribute des Objekts geändert werden können, ist die GUID unveränderlich.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein DirectoryEntry-Objekt erstellen und Pfad, Name und GUID ausgeben. In diesem Beispiel wird DirectoryEntry an den Stamm der Domäne gebunden, mit der der betreffende Benutzer derzeit verbunden ist.

Imports System.DirectoryServices
'...
Dim entry As New DirectoryEntry()
Console.WriteLine(entry.Path)
Console.WriteLine(entry.Name)
Console.WriteLine(entry.Guid)

using System.DirectoryServices;
//...
DirectoryEntry entry = new DirectoryEntry();
Console.WriteLine(entry.Path);
Console.WriteLine(entry.Name);
Console.WriteLine(entry.Guid);

Siehe auch

Referenz

System.DirectoryServices
DirectoryEntry

Konzepte

Erste Schritte in System.DirectoryServices
Binden von Zeichenfolgen

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Alle Rechte vorbehalten.