DirectoryContext 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 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) |