DirectoryEntry DirectoryEntry DirectoryEntry DirectoryEntry Class

Definition

Die DirectoryEntry-Klasse kapselt einen Knoten oder ein Objekt in der Active Directory-Domänendienste-Hierarchie.The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

public ref 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
Public Class DirectoryEntry
Inherits Component
Vererbung
Attribute

Hinweise

Verwenden Sie diese Klasse zum Binden an Objekte, oder lesen und Aktualisieren der Attribute an.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, zusammen mit Hilfsklassen, bietet Unterstützung für Lebenszyklus Verwaltung und Navigation-Methoden.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. Dazu gehören das Erstellen, löschen, umbenennen, verschieben einen untergeordneten Knoten und Auflisten von untergeordneten Elementen.These include creating, deleting, renaming, moving a child node, and enumerating children. Nachdem Sie einen Knoten ändern, müssen Sie einen commit für die Änderungen in der Reihenfolge, damit sie in der Struktur gespeichert werden.After you modify a node, you must commit your changes in order for them to be saved to the tree. Weitere Informationen finden Sie in den Ausführungen zur CommitChanges-Eigenschaft.For more information, see the CommitChanges property.

DirectoryEntry kann verwendet werden, auf die Schemaeinträge reguläre Einträge und einige, aber nicht alle Informationen zugreifen.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

Die Active Directory-Domänendienste-Hierarchie enthält bis zu mehreren Tausend Knoten.The Active Directory Domain Services hierarchy contains up to several thousand nodes. Jeder Knoten stellt ein Objekt, z. B. einem Netzwerkdrucker oder einen Benutzer in eine Domäne dar.Each node represents an object, such as a network printer or a user in a domain. Unternehmensnetzwerke ändern ständig neue Mitarbeiter eingestellt und Objekte, z. B. Netzwerkdrucker und Computer werden hinzugefügt.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Active Directory Service Interfaces (ADSI)-Technologie bietet Möglichkeiten, diese Objekte die Verzeichnisstruktur programmgesteuert hinzufügen.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

Verwenden Sie zum Erstellen von Active Directory-Eintrag in der Hierarchie der Children Eigenschaft.To create a directory entry in the hierarchy, use the Children property. Die Children Eigenschaft ist eine Sammlung, die bietet eine Add -Methode, mit der Sie einen Knoten hinzufügen, auf die Auflistung direkt unter dem übergeordneten Knoten, die Sie gebunden sind.The Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. Wenn Sie einen Knoten der Auflistung hinzufügen, müssen Sie angeben, einen Namen für den neuen Knoten und den Namen des Schemas, die mit dem Knoten zugeordnet werden soll.When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. Beispielsweise empfiehlt es sich um ein Schema mit dem Titel "Computer" zu verwenden, um neue Computer in der Hierarchie hinzugefügt.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Diese Klasse enthält auch Zwischenspeichern von Attributen, die für die Optimierung von Netzwerkverkehr hilfreich sein können.This class also contains attribute caching, which can be useful for optimizing network traffic. Zwischenspeichern von Attributen finden Sie unter den UsePropertyCache Eigenschaft.To use attribute caching, see the UsePropertyCache property.

Die Klassen im Zusammenhang mit der DirectoryEntry Komponente kann mit einem Active Directory Domain Services-Dienstanbieter verwendet werden.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. Einige der aktuellen Anbieter sind (Internet Information Services, IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) und WinNT.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

Hinweis

Es wird vorausgesetzt, dass Sie mit dieser Klasse werden grundlegende Kenntnisse im Umgang mit Active Directory Domain Services verfügen.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Weitere Informationen finden Sie unter den System.DirectoryServices -Namespace-Übersicht.For more information, see the System.DirectoryServices namespace overview.

Konstruktoren

DirectoryEntry() DirectoryEntry() DirectoryEntry() DirectoryEntry()

Initialisiert eine neue Instanz der DirectoryEntry-Klasse.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object)

Initialisiert eine neue Instanz der DirectoryEntry-Klasse, die an das angegebene systemeigene Active Directory-Domänendienste-Objekt gebunden ist.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String) DirectoryEntry(String) DirectoryEntry(String) 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.Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String)

Initialisiert eine neue Instanz der DirectoryEntry-Klasse.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes)

Initialisiert eine neue Instanz der DirectoryEntry-Klasse.Initializes a new instance of the DirectoryEntry class.

Eigenschaften

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

Ruft den Typ der zu verwendenden Authentifizierung ab oder legt diesen fest.Gets or sets the type of authentication to use.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Children Children Children Children

Ruft die untergeordneten Einträge dieses Knotens in der Active Directory-Domänendienste-Hierarchie ab.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Guid Guid Guid Guid

Ruft den GUID des DirectoryEntry ab.Gets the GUID of the DirectoryEntry.

Name Name Name Name

Ruft den Namen des Objekts entsprechend der Benennung im zugrunde liegenden Verzeichnisdienst ab.Gets the name of the object as named with the underlying directory service.

NativeGuid NativeGuid NativeGuid NativeGuid

Ruft die GUID des DirectoryEntry ab (wie vom Anbieter zurückgegeben).Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject NativeObject NativeObject NativeObject

Ruft das systemeigene ADSI-Objekt (Active Directory Services Interface) ab.Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity ObjectSecurity ObjectSecurity ObjectSecurity

Ruft die Sicherheitsbeschreibung für diesen Eintrag ab oder legt diese fest.Gets or sets the security descriptor for this entry.

Options Options Options Options

Ruft die anbieterspezifischen Optionen für diesen Eintrag ab.Gets the provider-specific options for this entry.

Parent Parent Parent Parent

Ruft das übergeordnete Element dieses Eintrags in der Active Directory-Domänendienste-Hierarchie ab.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password Password Password Password

Legt das Kennwort fest, mit dem der Client authentifiziert werden soll.Sets the password to use when authenticating the client.

Path Path Path Path

Ruft den Pfad für diesen DirectoryEntry ab oder legt diesen fest.Gets or sets the path for this DirectoryEntry.

Properties Properties Properties Properties

Ruft die Active Directory-Domänendienste-Eigenschaften für dieses DirectoryEntry-Objekt ab.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName SchemaClassName SchemaClassName SchemaClassName

Ruft den Namen der für dieses DirectoryEntry-Objekt verwendeten Schemaklasse ab.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry SchemaEntry SchemaEntry SchemaEntry

Ruft das Schemaobjekt für diesen Eintrag ab.Gets the schema object for this entry.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
UsePropertyCache UsePropertyCache UsePropertyCache UsePropertyCache

Ruft einen Wert ab, der angibt, ob der Cache nach jeder Operation übernommen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the cache should be committed after each operation.

Username Username Username Username

Ruft den für die Clientauthentifizierung zu verwendenden Benutzernamen ab oder legt diesen fest.Gets or sets the user name to use when authenticating the client.

Methoden

Close() Close() Close() Close()

Schließt das DirectoryEntry-Objekt und gibt sämtliche Systemressourcen frei, die dieser Komponente zugeordnet sind.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges() CommitChanges() CommitChanges() CommitChanges()

Speichert Änderungen, die an einem Verzeichniseintrag zum zugrunde liegenden Verzeichnisspeicher vorgenommen werden.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry)

Erstellt eine Kopie dieses Eintrags als untergeordnetes Element des angegebenen übergeordneten Elements.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String)

Erstellt eine Kopie dieses DirectoryEntry-Objekts als untergeordnetes Element des angegebenen übergeordneten DirectoryEntry-Objekts mit dem angegebenen neuen Namen.Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DeleteTree() DeleteTree() DeleteTree() DeleteTree()

Löscht diesen Eintrag und die gesamte zugehörige Teilstruktur aus der Active Directory-Domänendienste-Hierarchie.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die durch DirectoryEntry verwendeten Ressourcen (mit Ausnahme des Speichers) frei.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Exists(String) Exists(String) Exists(String) Exists(String)

Bestimmt, ob der angegebene Pfad einen tatsächlichen Eintrag im Verzeichnisdienst darstellt.Determines if the specified path represents an actual entry in the directory service.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als die Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[])

Ruft eine Methode im systemeigenen Active Directory-Domänendienste-Objekt auf.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String) InvokeGet(String) InvokeGet(String) InvokeGet(String)

Ruft eine Eigenschaft aus dem systemeigenen Active Directory-Domänendienste-Objekt ab.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[])

Legt eine Eigenschaft für das systemeigene Active Directory-Domänendienste-Objekt fest.Sets a property on the native Active Directory Domain Services object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry)

Verschiebt dieses DirectoryEntry-Objekt in das angegebene übergeordnete Element.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String)

Verschiebt dieses DirectoryEntry-Objekt in das angegebene übergeordnete Element und ändert dessen Namen in den angegebenen Wert.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache() RefreshCache() RefreshCache() RefreshCache()

Lädt die Eigenschaftswerte für dieses DirectoryEntry-Objekt in den Eigenschaftencache.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[])

Lädt die Werte der angegebenen Eigenschaften in den Eigenschaftencache.Loads the values of the specified properties into the property cache.

Rename(String) Rename(String) Rename(String) Rename(String)

Ändert den Namen dieses DirectoryEntry-Objekts.Changes the name of this DirectoryEntry object.

ToString() ToString() ToString() ToString()

Gibt eine String zurück, die den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Sicherheit

DirectoryServicesPermission
LinkDemand

Gilt für: