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
| Name | Beschreibung |
|---|---|
| PrincipalContext(ContextType) |
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp. |
| PrincipalContext(ContextType, String) |
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp und Namen. |
| PrincipalContext(ContextType, String, String) |
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen und Container. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Container und Kontextoptionen. |
| PrincipalContext(ContextType, String, String, String) |
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Benutzernamen und Kennwort. |
| PrincipalContext(ContextType, String, String, String, String) |
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Container, Benutzername und Kennwort. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Container, Kontextoptionen, Benutzername und 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 Hauptkontextobjekt 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 z. B. Benutzer oder Gruppen in den Domänenkontexttyp eingefügt werden, verwendet die Kontoverwaltungs-API den standardmäßigen bekannten Benutzercontainer "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 erstellt, ohne einen Container anzugeben. Da das Anwendungsverzeichnis nicht über bekannte Container verfügt, muss die Anwendung einen Container im Konstruktor oder das ArgumentException Auslösen angeben. Da SAM keine Container enthält, wird ein ArgumentException Fehler ausgelöst, wenn die Anwendung versucht, einen Container im Konstruktor anzugeben.
In jeder Version des Konstruktors, die einen Benutzernamen als Parameter akzeptiert, kann die userName Zeichenfolge in verschiedenen Formaten vorliegen. Die drei unterstützten NameFormats für nt4Name, UserPrincipalName und SamAccountName. Weitere Informationen zu Namensformaten finden Sie in der ADS_NAME_TYPE_ENUM Dokumentation.
PrincipalContext(ContextType)
- Quelle:
- Context.cs
- 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 Typ des Speichers für den Prinzipalkontext angibt.
Ausnahmen
Ein Name oder Container muss bei Verwendung des Anwendungsverzeichniskontexts 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
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp und Namen.
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 Typ des Speichers 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 des Ports, auf dem die ApplicationDirectory Instanz gehostet wird.
Wenn der Name für einen null Kontexttyp giltDomain, ist dieser Kontext ein Domänencontroller für die Domäne des Benutzerprinzipals, unter dem der Thread ausgeführt wird. Wenn der Name für einen null Kontexttyp giltMachine, ist dies der name des lokalen Computers. Dieser Parameter kann nicht für null Kontexttypen verwendet werdenApplicationDirectory.
Ausnahmen
Wenn im ApplicationDirectory Parameter angegeben wird, contextType 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
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen und 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 Typ des Speichers 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 des Ports, auf dem die ApplicationDirectory Instanz gehostet wird.
Wenn der Name für einen null Kontexttyp giltDomain, ist dieser Kontext ein Domänencontroller für die Domäne des Benutzerprinzipals, unter dem der Thread ausgeführt wird. Wenn der Name für einen null Kontexttyp giltMachine, ist dies der name des lokalen Computers. Dieser Parameter kann nicht für null Kontexttypen verwendet werdenApplicationDirectory.
- container
- String
Der Container im Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen werden unter diesem Stamm ausgeführt, und alle Einfügungen werden in diesem Container ausgeführt.
Für Domain und ApplicationDirectory Kontexttypen ist dieser Parameter der distinguished Name eines Containerobjekts.
Für Machine Kontexttypen muss dieser Parameter auf null.
Ausnahmen
Ein Container kann nicht angegeben werden, wenn der Machine Kontexttyp im contextType Parameter angegeben wird.
Ein Name oder Container muss angegeben werden, wenn ApplicationDirectory er contextType im Parameter angegeben wird.
Der contextType Parameter enthält keinen gültigen ContextType Enumerationswert.
Hinweise
Dies 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 wird als Objekt definiert, dessen Schemaklasse die Prinzipalklassen, entweder Benutzer-, Gruppen- oder Computer-Attribut, in seinem possibleInferiors-Attribut aufweist.
Gilt für:
PrincipalContext(ContextType, String, String, ContextOptions)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Container und 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 Typ des Speichers 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 des Ports, auf dem die ApplicationDirectory Instanz gehostet wird.
Wenn der Name für einen null Kontexttyp giltDomain, ist dieser Kontext ein Domänencontroller für die Domäne des Benutzerprinzipals, unter dem der Thread ausgeführt wird. Wenn der Name für einen null Kontexttyp giltMachine, ist dies der name des lokalen Computers. Dieser Parameter kann nicht für null Kontexttypen verwendet werdenApplicationDirectory.
- container
- String
Der Container im Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen werden unter diesem Stamm ausgeführt, und alle Einfügungen werden in diesem Container ausgeführt.
Für Domain und ApplicationDirectory Kontexttypen ist dieser Parameter der distinguished Name eines Containerobjekts.
Für Machine Kontexttypen muss dieser Parameter auf null.
- options
- ContextOptions
Eine Kombination aus einem oder ContextOptions mehreren Enumerationswerten, die die Optionen angeben, die zum Binden an den Server verwendet werden. Wenn dieser Parameter lautet null, sind die Standardoptionen ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Seal.
Ausnahmen
Ein Container kann nicht angegeben werden, wenn der Machine Kontexttyp im contextType Parameter angegeben wird.
Ein Name oder Container muss angegeben werden, wenn ApplicationDirectory er contextType im Parameter angegeben wird.
Der contextType Parameter enthält keinen gültigen ContextType Enumerationswert.
Der options Parameter enthält keine Kombination gültiger ContextOptions Enumerationswerte.
Hinweise
Dies 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 wird als Objekt definiert, dessen Schemaklasse die Prinzipalklassen, entweder Benutzer-, Gruppen- oder Computer-Attribut, in seinem possibleInferiors-Attribut aufweist.
Gilt für:
PrincipalContext(ContextType, String, String, String)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Benutzernamen und 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 Typ des Speichers 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 des Ports, auf dem die ApplicationDirectory Instanz gehostet wird.
Wenn der Name für einen null Kontexttyp giltDomain, ist dieser Kontext ein Domänencontroller für die Domäne des Benutzerprinzipals, unter dem der Thread ausgeführt wird. Wenn der Name für einen null Kontexttyp giltMachine, ist dies der name des lokalen Computers. Dieser Parameter kann nicht für null Kontexttypen verwendet werdenApplicationDirectory.
- userName
- String
Der Benutzername, der zum Herstellen einer Verbindung mit dem Store verwendet wird. Wenn beide Parameter userName vorhanden password sind null, werden die Anmeldeinformationen des aktuellen Prozesses verwendet. Andernfalls müssen beide userNamepassword nicht null sein, und die von ihnen angegebenen Anmeldeinformationen werden verwendet, um eine Verbindung mit dem Speicher herzustellen.
- password
- String
Das Kennwort, das zum Herstellen einer Verbindung mit dem Speicher verwendet wird. Wenn beide Parameter userName vorhanden password sind null, werden die Anmeldeinformationen des aktuellen Prozesses verwendet. Andernfalls müssen beide userNamepassword nicht null sein, und die von ihnen angegebenen Anmeldeinformationen werden verwendet, um eine Verbindung mit dem Speicher herzustellen.
Ausnahmen
Die userName Parameter password müssen entweder ein Wert sein null oder enthalten.
Wenn im ApplicationDirectory Parameter angegeben wird, contextType 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
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Container, Benutzername und 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 Typ des Speichers 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 des Ports, auf dem die ApplicationDirectory Instanz gehostet wird.
Wenn der Name für einen null Kontexttyp giltDomain, ist dieser Kontext ein Domänencontroller für die Domäne des Benutzerprinzipals, unter dem der Thread ausgeführt wird. Wenn der Name für einen null Kontexttyp giltMachine, ist dies der name des lokalen Computers. Dieser Parameter kann nicht für null Kontexttypen verwendet werdenApplicationDirectory.
- container
- String
Der Container im Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen werden unter diesem Stamm ausgeführt, und alle Einfügungen werden in diesem Container ausgeführt.
Für Domain und ApplicationDirectory Kontexttypen ist dieser Parameter der distinguished Name eines Containerobjekts.
Für Machine Kontexttypen muss dieser Parameter auf null.
- userName
- String
Der Benutzername, der zum Herstellen einer Verbindung mit dem Store verwendet wird. Wenn beide Parameter userName vorhanden password sind null, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Andernfalls müssen beide userNamepassword nicht null sein, und die von ihnen angegebenen Anmeldeinformationen werden verwendet, um eine Verbindung mit dem Speicher herzustellen.
- password
- String
Das Kennwort, das zum Herstellen einer Verbindung mit dem Speicher verwendet wird. Wenn beide Parameter userName vorhanden password sind null, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Andernfalls müssen beide userNamepassword nicht null sein, und die von ihnen angegebenen Anmeldeinformationen werden verwendet, um eine Verbindung mit dem Speicher herzustellen.
Ausnahmen
Die userName Parameter password müssen entweder ein Wert sein null oder enthalten.
Ein Container kann nicht angegeben werden, wenn der Machine Kontexttyp im contextType Parameter angegeben wird.
A name oder container muss angegeben werden, wenn ApplicationDirectory im contextType Parameter angegeben wird.
Der contextType Parameter enthält keinen gültigen ContextType Enumerationswert.
Hinweise
Dies 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 wird als Objekt definiert, dessen Schemaklasse die Prinzipalklassen, entweder Benutzer-, Gruppen- oder Computer-Attribut, in seinem possibleInferiors-Attribut aufweist.
Gilt für:
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
- Quelle:
- Context.cs
Initialisiert eine neue Instanz der PrincipalContext Klasse mit dem angegebenen Kontexttyp, Namen, Container, Kontextoptionen, Benutzername und 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 Typ des Speichers 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 des Ports, auf dem die ApplicationDirectory Instanz gehostet wird.
Wenn der Name für einen null Kontexttyp giltDomain, ist dieser Kontext ein Domänencontroller für die Domäne des Benutzerprinzipals, unter dem der Thread ausgeführt wird. Wenn der Name für einen null Kontexttyp giltMachine, ist dies der name des lokalen Computers. Dieser Parameter kann nicht für null Kontexttypen verwendet werdenApplicationDirectory.
- container
- String
Der Container im Speicher, der als Stamm des Kontexts verwendet werden soll. Alle Abfragen werden unter diesem Stamm ausgeführt, und alle Einfügungen werden in diesem Container ausgeführt.
Für Domain und ApplicationDirectory Kontexttypen ist dieser Parameter der distinguished Name eines Containerobjekts.
Für Machine Kontexttypen muss dieser Parameter auf null.
- options
- ContextOptions
Eine Kombination aus einem oder ContextOptions mehreren Enumerationswerten, die zum Binden an den Server verwendet werden. Wenn dieser Parameter lautet null, sind die Standardoptionen ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Seal.
- userName
- String
Der Benutzername, der zum Herstellen einer Verbindung mit dem Store verwendet wird. Wenn beide Parameter userName vorhanden password sind null, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Andernfalls müssen beide userNamepassword nicht null sein, und die von ihnen angegebenen Anmeldeinformationen werden verwendet, um eine Verbindung mit dem Speicher herzustellen.
- password
- String
Das Kennwort, das zum Herstellen einer Verbindung mit dem Speicher verwendet wird. Wenn beide Parameter userName vorhanden password sind null, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet. Andernfalls müssen beide userNamepassword nicht null sein, und die von ihnen angegebenen Anmeldeinformationen werden verwendet, um eine Verbindung mit dem Speicher herzustellen.
Ausnahmen
Die userName Parameter password müssen entweder ein Wert sein null oder enthalten.
Ein Container kann nicht angegeben werden, wenn der Machine Kontexttyp im contextType Parameter angegeben wird.
Ein Name oder Container muss angegeben werden, wenn ApplicationDirectory er contextType im Parameter angegeben wird.
Der contextType Parameter enthält keinen gültigen ContextType Enumerationswert.
Der options Parameter enthält keine Kombination gültiger ContextOptions Enumerationswerte.
Hinweise
Dies 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 wird als Objekt definiert, dessen Schemaklasse die Prinzipalklassen, entweder Benutzer-, Gruppen- oder Computer-Attribut, in seinem possibleInferiors-Attribut aufweist.
