DirectoryEntry Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die DirectoryEntry-Klasse kapselt einen Knoten oder ein Objekt in der Active Directory-Domänendienste-Hierarchie.
public ref class DirectoryEntry : System::ComponentModel::Componentpublic 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.Componenttype 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 ComponentPublic 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) |
