PrincipalContext Konstruktoren
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.
Initialisiert eine neue Instanz der PrincipalContext-Klasse.
Überlädt
| PrincipalContext(ContextType) |
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp. |
| PrincipalContext(ContextType, String) |
Initialisiert eine neue Instanz der PrincipalContext-Klasse unter Verwendung des angegebenen Kontexttyps und des angegebenen Namens. |
| PrincipalContext(ContextType, String, String) |
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen und dem angegebenen Container. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container sowie Kontextoptionen. |
| PrincipalContext(ContextType, String, String, String) |
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Benutzernamen und dem angegebenen Kennwort. |
| PrincipalContext(ContextType, String, String, String, String) |
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container, dem angegebenen Benutzernamen und dem angegebenen Kennwort. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container, den angegebenen Kontextoptionen, dem angegebenen Benutzernamen und dem angegebenen Kennwort. |
Hinweise
Die PrincipalContext Konstruktoren führen eine Überprüfung der Parameter und des Servers durch, versuchen jedoch nicht, Anmeldeinformationen zu überprüfen.
Wenn das Prinzipalkontextobjekt ohne Angabe eines Containers erstellt wird, kann es verwendet werden, um mehrere unterschiedliche Container darzustellen. Ein Container kann als Basis von Abfragevorgängen verwendet werden, während zusätzliche Container neu erstellte Prinzipalobjekte enthalten können. Wenn beispielsweise Benutzer oder Gruppen in den Domänenkontexttyp eingefügt werden, verwendet die Kontoverwaltungs-API den bekannten Standardbenutzercontainer "CN=Users,DC=Fabrikam,DC=com". Wenn Computer in den Speicher eingefügt werden, verwendet die API den Standardcontainer "CN=Computers,DC=Fabrikam,DC=com". Beachten Sie, dass die Standardcontainernamen vom Domänenadministrator geändert werden können. Da die Prinzipalobjektkonstruktoren nur einen Prinzipalkontext angeben können, werden zusätzliche Kontexte als Standardverhalten verfügbar gemacht, wenn die Anwendung einen Domänenkontext ohne Angabe eines Containers erstellt. Da das Anwendungsverzeichnis keine bekannten Container enthält, muss die Anwendung einen Container im Konstruktor angeben, oder der ArgumentException wird ausgelöst. Da SAM keine Container enthält, wird ein ArgumentException ausgelöst, wenn die Anwendung versucht, einen Container im Konstruktor anzugeben.
In jeder Version des Konstruktors, der einen Benutzernamen als Parameter akzeptiert, kann die userName Zeichenfolge in verschiedenen Formaten vorliegen. Die drei unterstützten NameFormats für sind Nt4Name, UserPrincipalName und SamAccountName. Weitere Informationen zu Namensformaten finden Sie in der Dokumentation zu ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType);public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType)Parameter
- contextType
- ContextType
Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.
Ausnahmen
Bei Verwendung des Anwendungsverzeichniskontexts muss ein Name oder ein Container angegeben werden.
Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.
Gilt für:
PrincipalContext(ContextType, String)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext-Klasse unter Verwendung des angegebenen Kontexttyps und des angegebenen Namens.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name);public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String)Parameter
- contextType
- ContextType
Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.
- name
- String
Der Name der Domäne oder des Servers für Domain-Kontexttypen, der Computername für Machine-Kontexttypen, oder der Name des Servers und der Name des Ports, die die ApplicationDirectory-Instanz hosten.
Wenn der Name für einen Domain-Kontexttyp null lautet, dann stellt dieser Kontexttyp einen Domänencontroller für die Domäne des Benutzerprinzipals dar, unter dem der Thread ausgeführt wird. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.
Ausnahmen
Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name angegeben werden.
Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.
Gilt für:
PrincipalContext(ContextType, String, String)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen und dem angegebenen Container.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container);public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String)Parameter
- contextType
- ContextType
Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.
- name
- String
Der Name der Domäne oder des Servers für Domain-Kontexttypen, der Computername für Machine-Kontexttypen, oder der Name des Servers und der Name des Ports, die die ApplicationDirectory-Instanz hosten.
Wenn der Name für einen Domain-Kontexttyp null lautet, dann stellt dieser Kontexttyp einen Domänencontroller für die Domäne des Benutzerprinzipals dar, unter dem der Thread ausgeführt wird. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.
- container
- String
Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.
Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.
Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.
Ausnahmen
Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.
Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name oder ein Container angegeben werden.
Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.
Hinweise
Die InvalidOperationException kann in nachfolgenden Verzeichnisvorgängen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der für einen Domain Prinzipalkontext angegebene Container kein gültiger Container ist. Ein Container ist als ein Objekt definiert, dessen Schemaklasse die Prinzipalklassen entweder Benutzer, Gruppe oder Computer im attribut possibleInferiors enthält.
Gilt für:
PrincipalContext(ContextType, String, String, ContextOptions)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container sowie Kontextoptionen.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options);public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)Parameter
- contextType
- ContextType
Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.
- name
- String
Der Name der Domäne oder des Servers für Domain-Kontexttypen, der Computername für Machine-Kontexttypen, oder der Name des Servers und der Name des Ports, die die ApplicationDirectory-Instanz hosten.
Wenn der Name für einen Domain-Kontexttyp null lautet, dann stellt dieser Kontexttyp einen Domänencontroller für die Domäne des Benutzerprinzipals dar, unter dem der Thread ausgeführt wird. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.
- container
- String
Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.
Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.
Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.
- options
- ContextOptions
Eine Kombination aus einem oder mehreren ContextOptions-Enumerationswerten, die die Optionen für die Serverbindung angeben. Wenn dieser Parameter null ist, sind die Standardoptionen ContextOptions.Negotiate, ContextOptions.Signing und ContextOptions.Sealing.
Ausnahmen
Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.
Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name oder ein Container angegeben werden.
Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.
Der options-Parameter enthält keine Kombination aus gültigen ContextOptions-Enumerationswerten.
Hinweise
Die InvalidOperationException kann in nachfolgenden Verzeichnisvorgängen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der für einen Domain Prinzipalkontext angegebene Container kein gültiger Container ist. Ein Container ist als ein Objekt definiert, dessen Schemaklasse die Prinzipalklassen entweder Benutzer, Gruppe oder Computer im attribut possibleInferiors enthält.
Gilt für:
PrincipalContext(ContextType, String, String, String)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Benutzernamen und dem angegebenen Kennwort.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ userName, System::String ^ password);public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string userName, string password);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, userName As String, password As String)Parameter
- contextType
- ContextType
Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.
- name
- String
Der Name der Domäne oder des Servers für Domain-Kontexttypen, der Computername für Machine-Kontexttypen, oder der Name des Servers und der Name des Ports, die die ApplicationDirectory-Instanz hosten.
Wenn der Name für einen Domain-Kontexttyp null lautet, dann stellt dieser Kontexttyp einen Domänencontroller für die Domäne des Benutzerprinzipals dar, unter dem der Thread ausgeführt wird. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.
- userName
- String
Der Benutzername zum Herstellen einer Verbindung mit dem Speicher. Wenn die Parameter userName und password jeweils null sind, werden die Anmeldeinformationen des aktuellen Prozesses verwendet. Wenn sowohl der userName-Parameter als auch der password-Parameter ungleich NULL sind, werden die von diesen Parametern angegebenen Anmeldeinformationen zum Herstellen einer Verbindung mit dem Speicher verwendet.
- password
- String
Das Kennwort, das verwendet wird, um eine Verbindung mit dem Speicher herzustellen. Wenn die Parameter userName und password jeweils null sind, werden die Anmeldeinformationen des aktuellen Prozesses verwendet. Wenn sowohl der userName-Parameter als auch der password-Parameter ungleich NULL sind, werden die von diesen Parametern angegebenen Anmeldeinformationen zum Herstellen einer Verbindung mit dem Speicher verwendet.
Ausnahmen
Der username-Parameter und der password-Parameter müssen entweder null sein oder einen Wert enthalten.
Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name angegeben werden.
Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.
Gilt für:
PrincipalContext(ContextType, String, String, String, String)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container, dem angegebenen Benutzernamen und dem angegebenen Kennwort.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::String ^ userName, System::String ^ password);public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, string userName, string password);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)Parameter
- contextType
- ContextType
Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.
- name
- String
Der Name der Domäne oder des Servers für Domain-Kontexttypen, der Computername für Machine-Kontexttypen, oder der Name des Servers und der Name des Ports, die die ApplicationDirectory-Instanz hosten.
Wenn der Name für einen Domain-Kontexttyp null lautet, dann stellt dieser Kontexttyp einen Domänencontroller für die Domäne des Benutzerprinzipals dar, unter dem der Thread ausgeführt wird. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.
- container
- String
Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.
Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.
Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.
- userName
- String
Der Benutzername zum Herstellen einer Verbindung mit dem Speicher. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Wenn sowohl der userName-Parameter als auch der password-Parameter ungleich NULL sind, werden die von diesen Parametern angegebenen Anmeldeinformationen zum Herstellen einer Verbindung mit dem Speicher verwendet.
- password
- String
Das Kennwort, das verwendet wird, um eine Verbindung mit dem Speicher herzustellen. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Wenn sowohl der userName-Parameter als auch der password-Parameter ungleich NULL sind, werden die von diesen Parametern angegebenen Anmeldeinformationen zum Herstellen einer Verbindung mit dem Speicher verwendet.
Ausnahmen
Der username-Parameter und der password-Parameter müssen entweder null sein oder einen Wert enthalten.
Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.
Ein name oder ein container muss angegeben werden, wenn ApplicationDirectory im contextType-Parameter angegeben wird.
Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.
Hinweise
Die InvalidOperationException kann in nachfolgenden Verzeichnisvorgängen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der für einen Domain Prinzipalkontext angegebene Container kein gültiger Container ist. Ein Container ist als ein Objekt definiert, dessen Schemaklasse die Prinzipalklassen entweder Benutzer, Gruppe oder Computer im attribut possibleInferiors enthält.
Gilt für:
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container, den angegebenen Kontextoptionen, dem angegebenen Benutzernamen und dem angegebenen Kennwort.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options, System::String ^ userName, System::String ^ password);public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options, string userName, string password);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions, userName As String, password As String)Parameter
- contextType
- ContextType
Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.
- name
- String
Der Name der Domäne oder des Servers für Domain-Kontexttypen, der Computername für Machine-Kontexttypen, oder der Name des Servers und der Name des Ports, die die ApplicationDirectory-Instanz hosten.
Wenn der Name für einen Domain-Kontexttyp null lautet, dann stellt dieser Kontexttyp einen Domänencontroller für die Domäne des Benutzerprinzipals dar, unter dem der Thread ausgeführt wird. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.
- container
- String
Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.
Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.
Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.
- options
- ContextOptions
Eine Kombination aus einem oder mehreren ContextOptions-Enumerationswerten, die die Optionen für die Serverbindung angeben. Wenn dieser Parameter null ist, sind die Standardoptionen ContextOptions.Negotiate, ContextOptions.Signing und ContextOptions.Sealing.
- userName
- String
Der Benutzername zum Herstellen einer Verbindung mit dem Speicher. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Wenn sowohl der userName-Parameter als auch der password-Parameter ungleich NULL sind, werden die von diesen Parametern angegebenen Anmeldeinformationen zum Herstellen einer Verbindung mit dem Speicher verwendet.
- password
- String
Das Kennwort, das verwendet wird, um eine Verbindung mit dem Speicher herzustellen. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Wenn sowohl der userName-Parameter als auch der password-Parameter ungleich NULL sind, werden die von diesen Parametern angegebenen Anmeldeinformationen zum Herstellen einer Verbindung mit dem Speicher verwendet.
Ausnahmen
Der username-Parameter und der password-Parameter müssen entweder null sein oder einen Wert enthalten.
Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.
Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name oder ein Container angegeben werden.
Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.
Der options-Parameter enthält keine Kombination aus gültigen ContextOptions-Enumerationswerten.
Hinweise
Kann InvalidOperationException in nachfolgenden Verzeichnisvorgängen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der für einen Domain Prinzipalkontext angegebene Container kein gültiger Container ist. Ein Container wird als ein Objekt definiert, dessen Schemaklasse im attribut possibleInferiors die Prinzipalklassen entweder user, group oder computer enthält.
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für