DirectoryContext Klasse

Definition

Die DirectoryContext-Klasse bezeichnet ein bestimmtes Verzeichnis und die Anmeldeinformationen, die für den Zugriff auf dieses verwendet werden.

public ref class DirectoryContext
public class DirectoryContext
type DirectoryContext = class
Public Class DirectoryContext
Vererbung
DirectoryContext

Hinweise

Vor dem Zugriff auf die Methoden und Eigenschaften eines System.DirectoryServices.ActiveDirectory-Verzeichnisobjekts, z. B. einer Domäne oder Gesamtstruktur, muss ein Verzeichniskontext erstellt werden.

Beim Erstellen eines Verzeichniskontexts können die aktuellen Anmeldeinformationen oder alternativen Anmeldeinformationen des Prozesses mithilfe des entsprechenden Konstruktors auf diesen Kontext angewendet werden. Diese Anmeldeinformationen bestimmen die Berechtigungen, die wirksam sind, wenn das Programm auf Verzeichnisobjekte zugreift. Da Active Directory Domain Services Objekte möglicherweise vor Dem Abrufen oder Ändern durch nicht administrative Benutzer geschützt sind, ist die Verwendung alternativer Anmeldeinformationen mit Berechtigung für den Zugriff auf die Zielobjekte manchmal für die ordnungsgemäße Programmfunktionalität erforderlich.

Die folgende Tabelle enthält eine Liste der zulässigen Zieltypen und eine Beschreibung des Formats der Zielzeichenfolge.

Zieltyp DirectoryContextType -Member Format des Zielnamens
Domänencontroller DirectoryServer Der DNS-Name des Domänencontrollers.
AD LDS-Instanz DirectoryServer Der DNS-Name des AD LDS-Servers und die LDAP-Portnummer, z. B. ad_lds_instance.fabrikam.com:389.
Domain Domain Der DNS-Name der Domäne, z. B. sales.corp.fabrikam.com.
Gesamtstruktur Forest Der DNS-Name der Gesamtstruktur, z. B. corp.fabrikam.com.
Anwendungspartition ApplicationPartition Der DNS-Name der Anwendungspartition.
AD LDS-Konfigurationssatz ConfigurationSet Eines der Schlüsselwörter, das dem Dienstverbindungspunkt zugeordnet ist, der von AD LDS-Instanzen für den Konfigurationssatz registriert wurde.

Konstruktoren

DirectoryContext(DirectoryContextType)

Initialisiert eine neue Instanz der DirectoryContext-Klasse des angegebenen Typs, die die Anmeldeinformationen des aktuellen Benutzerkontexts enthält.

DirectoryContext(DirectoryContextType, String)

Initialisiert eine neue Instanz der DirectoryContext-Klasse des angegebenen Typs, die den angegebenen Namen und die Anmeldeinformationen des aktuellen Benutzerkontexts enthält.

DirectoryContext(DirectoryContextType, String, String)

Initialisiert eine neue Instanz der DirectoryContext-Klasse des angegebenen Typs, die den angegebenen Benutzernamen und das angegebene Kennwort enthält.

DirectoryContext(DirectoryContextType, String, String, String)

Initialisiert eine neue Instanz der DirectoryContext-Klasse des angegebenen Typs, die das angegebene Ziel, den angegebenen Benutzernamen und das angegebene Kennwort enthält.

Eigenschaften

ContextType

Ruft den Typ des Kontextobjekts ab.

Name

Ruft den Namen des Kontexts ab.

UserName

Ruft den Benutzernamen des Kontexts ab.

Methoden

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für: