Freigeben über


DirectoryEntry Klasse

Definition

Die DirectoryEntry-Klasse kapselt einen Knoten oder ein Objekt in der Active Directory-Domänendienste-Hierarchie.

public ref class DirectoryEntry : System::ComponentModel::Component
public class DirectoryEntry : System.ComponentModel.Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
[<System.DirectoryServices.DSDescription("DirectoryEntryDesc")>]
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
Vererbung
Attribute

Hinweise

Verwenden Sie diese Klasse zum Binden an Objekte oder zum Lesen und Aktualisieren von Attributen. DirectoryEntrybietet zusammen mit Hilfsklassen Unterstützung für Lebenszyklusverwaltungs- und Navigationsmethoden. Dazu gehören das Erstellen, Löschen, Umbenennen, Verschieben eines untergeordneten Knotens und Das Aufzählen von untergeordneten Elementen. Nachdem Sie einen Knoten geändert haben, müssen Sie Ihre Änderungen committen, damit sie in der Struktur gespeichert werden können. Weitere Informationen finden Sie in den Ausführungen zur CommitChanges-Eigenschaft.

DirectoryEntry kann verwendet werden, um auf reguläre Einträge und einige, aber nicht alle Informationen aus Schemaeinträgen zuzugreifen.

Die Active Directory Domain Services-Hierarchie enthält bis zu mehrere Tausend Knoten. Jeder Knoten stellt ein Objekt dar, z. B. einen Netzwerkdrucker oder einen Benutzer in einer Domäne. Unternehmensnetzwerke ändern sich ständig, wenn neue Mitarbeiter eingestellt werden und Objekte wie Netzwerkdrucker und Computer hinzugefügt werden. Die ADSI-Technologie (Active Directory Service Interfaces) bietet Möglichkeiten zum programmgesteuerten Hinzufügen dieser Objekte zur Verzeichnisstruktur.

Verwenden Sie die -Eigenschaft, um einen Verzeichniseintrag in der Children Hierarchie zu erstellen. Die Children -Eigenschaft ist eine Auflistung, die eine Add -Methode bereitstellt, mit der Sie der Auflistung direkt unterhalb des übergeordneten Knotens, an den Sie derzeit gebunden sind, einen Knoten hinzufügen. 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. Beispielsweise können Sie ein Schema mit dem Titel "Computer" verwenden, um der Hierarchie neue Computer hinzuzufügen.

Diese Klasse enthält auch Attributzwischenspeicherung, die für die Optimierung des Netzwerkdatenverkehrs nützlich sein kann. Informationen zur Verwendung der Attributzwischenspeicherung finden Sie in der UsePropertyCache -Eigenschaft.

Die der DirectoryEntry Komponente zugeordneten Klassen können mit jedem der Active Directory Domain Services-Dienstanbieter verwendet werden. Einige der aktuellen Anbieter sind Internetinformationsdienste (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) und WinNT.

Hinweis

Es wird davon ausgegangen, dass Sie über allgemeine Kenntnisse Active Directory Domain Services verfügen, bevor Sie diese Klasse verwenden. Weitere Informationen finden Sie in der System.DirectoryServices Namespaceübersicht.

Konstruktoren

DirectoryEntry()

Initialisiert eine neue Instanz der DirectoryEntry-Klasse.

DirectoryEntry(Object)

Initialisiert eine neue Instanz der DirectoryEntry-Klasse, die an das angegebene systemeigene Active Directory-Domänendienste-Objekt gebunden ist.

DirectoryEntry(String)

Initialisiert eine neue Instanz der DirectoryEntry-Klasse, die diese Instanz an den Knoten in Active Directory-Domänendiensten bindet, der sich am angegeben Pfad befindet.

DirectoryEntry(String, String, String)

Initialisiert eine neue Instanz der DirectoryEntry-Klasse.

DirectoryEntry(String, String, String, AuthenticationTypes)

Initialisiert eine neue Instanz der DirectoryEntry-Klasse.

Eigenschaften

AuthenticationType

Ruft den Typ der zu verwendenden Authentifizierung ab oder legt diesen fest.

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
Children

Ruft die untergeordneten Einträge dieses Knotens in der Active Directory-Domänendienste-Hierarchie ab.

Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
Guid

Ruft die GUID von DirectoryEntry ab.

Name

Ruft den Namen des Objekts entsprechend der Benennung im zugrunde liegenden Verzeichnisdienst ab.

NativeGuid

Ruft die GUID des DirectoryEntry ab (wie vom Anbieter zurückgegeben).

NativeObject

Ruft das systemeigene ADSI-Objekt (Active Directory Services Interface) ab.

ObjectSecurity

Ruft die Sicherheitsbeschreibung für diesen Eintrag ab oder legt diese fest.

Options

Ruft die anbieterspezifischen Optionen für diesen Eintrag ab.

Parent

Ruft das übergeordnete Element dieses Eintrags in der Active Directory-Domänendienste-Hierarchie ab.

Password

Legt das Kennwort fest, mit dem der Client authentifiziert werden soll.

Path

Ruft den Pfad für diesen DirectoryEntry ab oder legt diesen fest.

Properties

Ruft die Active Directory-Domänendienste-Eigenschaften für dieses DirectoryEntry-Objekt ab.

SchemaClassName

Ruft den Namen der für dieses DirectoryEntry-Objekt verwendeten Schemaklasse ab.

SchemaEntry

Ruft das Schemaobjekt für diesen Eintrag ab.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
UsePropertyCache

Ruft einen Wert ab, der angibt, ob der Cache nach jeder Operation übernommen werden soll, oder legt diesen fest.

Username

Ruft den für die Clientauthentifizierung zu verwendenden Benutzernamen ab oder legt diesen fest.

Methoden

Close()

Schließt das DirectoryEntry-Objekt und gibt sämtliche Systemressourcen frei, die dieser Komponente zugeordnet sind.

CommitChanges()

Speichert Änderungen, die an einem Verzeichniseintrag zum zugrunde liegenden Verzeichnisspeicher vorgenommen werden.

CopyTo(DirectoryEntry)

Erstellt eine Kopie dieses Eintrags als untergeordnetes Element des angegebenen übergeordneten Elements.

CopyTo(DirectoryEntry, String)

Erstellt eine Kopie dieses DirectoryEntry-Objekts als untergeordnetes Element des angegebenen übergeordneten DirectoryEntry-Objekts mit dem angegebenen neuen Namen.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
DeleteTree()

Löscht diesen Eintrag und die gesamte zugehörige Teilstruktur aus der Active Directory-Domänendienste-Hierarchie.

Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die durch DirectoryEntry verwendeten Ressourcen (mit Ausnahme des Speichers) frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Exists(String)

Bestimmt, ob der angegebene Pfad einen tatsächlichen Eintrag im Verzeichnisdienst darstellt.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
Invoke(String, Object[])

Ruft eine Methode im systemeigenen Active Directory-Domänendienste-Objekt auf.

InvokeGet(String)

Ruft eine Eigenschaft aus dem systemeigenen Active Directory-Domänendienste-Objekt ab.

InvokeSet(String, Object[])

Legt eine Eigenschaft für das systemeigene Active Directory-Domänendienste-Objekt fest.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
MoveTo(DirectoryEntry)

Verschiebt dieses DirectoryEntry-Objekt in das angegebene übergeordnete Element.

MoveTo(DirectoryEntry, String)

Verschiebt dieses DirectoryEntry-Objekt in das angegebene übergeordnete Element und ändert dessen Namen in den angegebenen Wert.

RefreshCache()

Lädt die Eigenschaftswerte für dieses DirectoryEntry-Objekt in den Eigenschaftencache.

RefreshCache(String[])

Lädt die Werte der angegebenen Eigenschaften in den Eigenschaftencache.

Rename(String)

Ändert den Namen dieses DirectoryEntry-Objekts.

ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden.

(Geerbt von Component)

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Gilt für: