Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die DirectoryEntry-Klasse kapselt einen Knoten oder ein Objekt in der Active Directory-Hierarchie.
Namespace: System.DirectoryServices
Assembly: System.DirectoryServices (in system.directoryservices.dll)
Syntax
'Declaration
Public Class DirectoryEntry
Inherits Component
'Usage
Dim instance As DirectoryEntry
public class DirectoryEntry : Component
public ref class DirectoryEntry : public Component
public class DirectoryEntry extends Component
public class DirectoryEntry extends Component
Hinweise
Verwenden Sie diese Klasse zum Binden an Objekte oder zum Lesen und Aktualisieren von Attributen. DirectoryEntry unterstützt zusammen mit Hilfsklassen die Verwaltung des Lebenszyklus und der Navigationsmethoden. Dazu gehört das Erstellen, Löschen, Umbenennen und Verschieben von untergeordneten Knoten und die Auflistung untergeordneter Elemente. Nach dem Ändern eines Knotens müssen Sie die Änderungen übernehmen, damit diese in der Struktur gespeichert werden. Weitere Informationen finden Sie unter der CommitChanges-Eigenschaft.
Mithilfe von DirectoryEntry können Sie auf reguläre Einträge und einige, jedoch nicht alle, Informationen aus den Schemaeinträgen zugreifen.
Die Active Directory-Hierarchie kann bis zu mehreren tausend Knoten enthalten. Jeder Knoten stellt ein Objekt dar, beispielsweise einen Netzwerkdrucker oder einen Benutzer in einer Domäne. Firmennetzwerke unterliegen ständigen Änderungen, wenn z. B. neue Mitarbeiter eingestellt und Objekte wie Netzwerkdrucker und Computer hinzugefügt werden. Mithilfe der ADSI-Technologie (Active Directory Service Interfaces ) können diese Objekte der Verzeichnisstruktur programmgesteuert hinzugefügt werden.
Zum Erstellen eines Verzeichniseintrags in der Hierarchie verwenden Sie die Children-Eigenschaft. Die Children Eigenschaft stellt eine Auflistung dar, die eine Add-Methode enthält, mit der Sie der Auflistung einen Knoten direkt unter dem übergeordneten Knoten hinzufügen können, an den Sie gegenwärtig gebunden sind. Wenn Sie der Auflistung einen Knoten hinzufügen, müssen Sie einen Namen für den neuen Knoten und den Namen einer Schemavorlage angeben, die Sie dem Knoten zuordnen möchten. So könnten Sie beispielsweise ein Schema mit dem Namen "Computer" verwenden, um der Hierarchie weitere Computer hinzuzufügen.
Diese Klasse ermöglicht auch das Zwischenspeichern von Attributen, wodurch der Netzwerkverkehr optimiert werden kann. Weitere Informationen zum Zwischenspeichern von Attributen finden Sie unter der UsePropertyCache-Eigenschaft.
Die der DirectoryEntry-Komponente zugeordneten Klassen können mit jedem Active Directory-Dienstanbieter verwendet werden. Einige der aktuellen Anbieter sind IIS (Internetinformationsdienste), LDAP (Lightweight Directory Access Protocol), NDS (NetWare Directory Service von Novell) und WinNT.
Hinweis
Für die Verwendung diese Klasse werden grundlegende Kenntnisse im Umgang mit Active Directory vorausgesetzt. Weitere Informationen finden Sie in der Übersicht über den System.DirectoryServices-Namespace.
.NET Framework-Sicherheit
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.DirectoryServices.DirectoryEntry
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0