PrincipalContext PrincipalContext PrincipalContext Constructors

Definition

Überlädt

PrincipalContext(ContextType) PrincipalContext(ContextType) PrincipalContext(ContextType)

Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp.Initializes a new instance of the PrincipalContext class with the specified context type.

PrincipalContext(ContextType, String) PrincipalContext(ContextType, String) PrincipalContext(ContextType, String)

Initialisiert eine neue Instanz der PrincipalContext-Klasse unter Verwendung des angegebenen Kontexttyps und des angegebenen Namens.Initializes a new instance of the PrincipalContext class with the specified context type and name.

PrincipalContext(ContextType, String, String) PrincipalContext(ContextType, String, String) PrincipalContext(ContextType, String, String)

Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen und dem angegebenen Container.Initializes a new instance of the PrincipalContext class with the specified context type, name, and container.

PrincipalContext(ContextType, String, String, ContextOptions) PrincipalContext(ContextType, String, String, ContextOptions) PrincipalContext(ContextType, String, String, ContextOptions)

Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container sowie Kontextoptionen.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, and context options.

PrincipalContext(ContextType, String, String, String) PrincipalContext(ContextType, String, String, String) 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.Initializes a new instance of the PrincipalContext class with the specified context type, name, username, and password.

PrincipalContext(ContextType, String, String, String, String) PrincipalContext(ContextType, String, String, String, String) 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.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, username, and password.

PrincipalContext(ContextType, String, String, ContextOptions, String, String) PrincipalContext(ContextType, String, String, ContextOptions, String, String) 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.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, context options, username, and password.

Hinweise

Die PrincipalContext Konstruktoren führen die Validierung der Parameter und des Servers aus, versuchen aber nicht, die Anmelde Informationen zu überprüfen.The PrincipalContext constructors perform validation of the parameters and server, but not do not attempt to validate credentials.

Wenn das Prinzipal Kontext Objekt erstellt wird, ohne einen Container anzugeben, kann es verwendet werden, um mehrere unterschiedliche Container darzustellen.When the principal context object is created without specifying a container, it may be used to represent multiple distinct containers. Ein Container kann als Basis von Abfrage Vorgängen verwendet werden, während zusätzliche Container neu erstellte Prinzipal Objekte enthalten können.One container may be used as the base of query operations, while additional containers can hold newly-created principal objects. Wenn z. b. Benutzer oder Gruppen in den Domänen Kontexttyp eingefügt werden, wird von der Kontoverwaltungs-API der standardmäßige bekannte Benutzer Container "CN = Users, DC = fabrikam, DC = com" verwendet.For example, when users or groups are inserted into the domain context type, the Account Management API uses the default well-known user container, "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".When computers are inserted in the store, the API uses the default "CN=Computers,DC=Fabrikam,DC=com" container. Beachten Sie, dass die Standardcontainer Namen vom Domänen Administrator geändert werden können.Note that the default container names can be changed by the domain administrator. Da die Prinzipal Objektkonstruktoren nur einen Prinzipal Kontext angeben können, werden zusätzliche Kontexte als Standardverhalten verfügbar gemacht, wenn die Anwendung einen Domänen Kontext erstellt, ohne einen Container anzugeben.Since the principal object constructors can only specify one principal context, additional contexts are exposed as the default behavior when the application creates a domain context without specifying a container. Da das Anwendungsverzeichnis nicht über bekannte Container verfügt, muss die Anwendung einen Container im Konstruktor angeben, oder die ArgumentException wird ausgelöst.Since the application directory does not have well-known containers, the application must specify a container in the constructor or the ArgumentException is thrown. Da Sam keine Container hat, wird eine ArgumentException ausgelöst, wenn die Anwendung versucht, einen Container im Konstruktor anzugeben.Since SAM does not have containers, a ArgumentException is thrown if the application attempts to specify a container in the constructor.

In jeder Version des Konstruktors, der einen Benutzernamen als Parameter annimmt, kann die userName Zeichenfolge in verschiedenen Formaten vorliegen.In each version of the constructor that takes a user name as a parameter, the userName string can be in various different formats. Die drei unterstützten nameformate für sind Nt4Name, userPrincipalName und sAMAccountName.The three supported NameFormats for are Nt4Name, UserPrincipalName, and SamAccountName. Weitere Informationen zu namens Formaten finden Sie in der ADS_NAME_TYPE_ENUM- Dokumentation.For more information about name formats, see the ADS_NAME_TYPE_ENUM documentation here.

PrincipalContext(ContextType) PrincipalContext(ContextType) PrincipalContext(ContextType)

Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp.Initializes a new instance of the PrincipalContext class with the specified context type.

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.PrincipalContext

Parameter

contextType
ContextType ContextType ContextType

Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.A ContextType enumeration value specifying the type of store for the principal context.

Ausnahmen

Bei Verwendung des Anwendungsverzeichniskontexts muss ein Name oder ein Container angegeben werden.A name or container must be specified when using the application directory context.

Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.The contextType parameter does not contain a valid ContextType enumeration value.

PrincipalContext(ContextType, String) PrincipalContext(ContextType, String) PrincipalContext(ContextType, String)

Initialisiert eine neue Instanz der PrincipalContext-Klasse unter Verwendung des angegebenen Kontexttyps und des angegebenen Namens.Initializes a new instance of the PrincipalContext class with the specified context type and name.

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.PrincipalContext

Parameter

contextType
ContextType ContextType ContextType

Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.A ContextType enumeration value specifying the type of store for the principal context.

name
String String 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.The name of the domain or server for Domain context types, the machine name for Machine context types, or the name of the server and port hosting the ApplicationDirectory instance.

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.If the name is null for a Domain context type this context is a domain controller for the domain of the user principal under which the thread is running. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers.If the name is null for a Machine context type, this is the local machine name. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.This parameter cannot be null for ApplicationDirectory context types.

Ausnahmen

Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name angegeben werden.A name must be specified when ApplicationDirectory is specified in the contextType parameter.

Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.The contextType parameter does not contain a valid ContextType enumeration value.

PrincipalContext(ContextType, String, String) PrincipalContext(ContextType, String, String) PrincipalContext(ContextType, String, String)

Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen und dem angegebenen Container.Initializes a new instance of the PrincipalContext class with the specified context type, name, and 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.PrincipalContext

Parameter

contextType
ContextType ContextType ContextType

Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.A ContextType enumeration value specifying the type of store for the principal context.

name
String String 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.The name of the domain or server for Domain context types, the machine name for Machine context types, or the name of the server and port hosting the ApplicationDirectory instance.

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.If the name is null for a Domain context type this context is a domain controller for the domain of the user principal under which the thread is running. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers.If the name is null for a Machine context type, this is the local machine name. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.This parameter cannot be null for ApplicationDirectory context types.

container
String String String

Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll.The container on the store to use as the root of the context. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.All queries are performed under this root, and all inserts are performed into this container.

Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.For Machine context types, this parameter must be set to null.

Ausnahmen

Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name oder ein Container angegeben werden.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.The contextType parameter does not contain a valid ContextType enumeration value.

Hinweise

Kann in nachfolgenden Verzeichnis Vorgangs aufrufen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der Domain für einen Prinzipal Kontext angegebene Container kein gültiger Container ist. InvalidOperationExceptionThe InvalidOperationException may be thrown in subsequent directory operations calls that connect to the server if the container specified for a Domain principal context is not a valid container. Ein Container ist als ein Objekt definiert, dessen Schema Klasse die Prinzipal Klassen (Benutzer, Gruppe oder Computer) im Attribut "PossibleInferiors" enthält.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

PrincipalContext(ContextType, String, String, ContextOptions) PrincipalContext(ContextType, String, String, ContextOptions) PrincipalContext(ContextType, String, String, ContextOptions)

Initialisiert eine neue Instanz der PrincipalContext-Klasse mit dem angegebenen Kontexttyp, dem angegebenen Namen, dem angegebenen Container sowie Kontextoptionen.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, and context options.

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.PrincipalContext

Parameter

contextType
ContextType ContextType ContextType

Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.A ContextType enumeration value specifying the type of store for the principal context.

name
String String 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.The name of the domain or server for Domain context types, the machine name for Machine context types, or the name of the server and port hosting the ApplicationDirectory instance.

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.If the name is null for a Domain context type this context is a domain controller for the domain of the user principal under which the thread is running. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers.If the name is null for a Machine context type, this is the local machine name. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.This parameter cannot be null for ApplicationDirectory context types.

container
String String String

Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll.The container on the store to use as the root of the context. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.All queries are performed under this root, and all inserts are performed into this container.

Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.For Machine context types, this parameter must be set to null.

options
ContextOptions ContextOptions ContextOptions

Eine Kombination aus einem oder mehreren ContextOptions-Enumerationswerten, die die Optionen für die Serverbindung angeben.A combination of one or more ContextOptions enumeration values specifying the options used to bind to the server. Wenn dieser Parameter null ist, sind die Standardoptionen ContextOptions.Negotiate, ContextOptions.Signing und ContextOptions.Sealing.If this parameter is null, the default options are ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

Ausnahmen

Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name oder ein Container angegeben werden.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.The contextType parameter does not contain a valid ContextType enumeration value.

Der options-Parameter enthält keine Kombination aus gültigen ContextOptions-Enumerationswerten.The options parameter does not contain a combination of valid ContextOptions enumeration values.

Hinweise

Kann in nachfolgenden Verzeichnis Vorgangs aufrufen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der Domain für einen Prinzipal Kontext angegebene Container kein gültiger Container ist. InvalidOperationExceptionThe InvalidOperationException may be thrown in subsequent directory operations calls that connect to the server if the container specified for a Domain principal context is not a valid container. Ein Container ist als ein Objekt definiert, dessen Schema Klasse die Prinzipal Klassen (Benutzer, Gruppe oder Computer) im Attribut "PossibleInferiors" enthält.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

PrincipalContext(ContextType, String, String, String) PrincipalContext(ContextType, String, String, String) 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.Initializes a new instance of the PrincipalContext class with the specified context type, name, username, and password.

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.PrincipalContext

Parameter

contextType
ContextType ContextType ContextType

Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.A ContextType enumeration value specifying the type of store for the principal context.

name
String String 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.The name of the domain or server for Domain context types, the machine name for Machine context types, or the name of the server and port hosting the ApplicationDirectory instance.

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.If the name is null for a Domain context type this context is a domain controller for the domain of the user principal under which the thread is running. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers.If the name is null for a Machine context type, this is the local machine name. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.This parameter cannot be null for ApplicationDirectory context types.

userName
String String String

Der Benutzername zum Herstellen einer Verbindung mit dem Speicher.The username used to connect to the store. Wenn die Parameter userName und password jeweils null sind, werden die Anmeldeinformationen des aktuellen Prozesses verwendet.If the userName and password parameters are both null, the credentials of the current process are used. 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.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

password
String String String

Das Kennwort, das verwendet wird, um eine Verbindung mit dem Speicher herzustellen.The password used to connect to the store. Wenn die Parameter userName und password jeweils null sind, werden die Anmeldeinformationen des aktuellen Prozesses verwendet.If the userName and password parameters are both null, the credentials of the current process are used. 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.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

Ausnahmen

Der username-Parameter und der password-Parameter müssen entweder null sein oder einen Wert enthalten.The username and password parameters must either be null or contain a value.

Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name angegeben werden.A name must be specified when ApplicationDirectory is specified in the contextType parameter.

Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.The contextType parameter does not contain a valid ContextType enumeration value.

PrincipalContext(ContextType, String, String, String, String) PrincipalContext(ContextType, String, String, String, String) 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.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, username, and password.

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.PrincipalContext

Parameter

contextType
ContextType ContextType ContextType

Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.A ContextType enumeration value specifying the type of store for the principal context.

name
String String 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.The name of the domain or server for Domain context types, the machine name for Machine context types, or the name of the server and port hosting the ApplicationDirectory instance.

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.If the name is null for a Domain context type this context is a domain controller for the domain of the user principal under which the thread is running. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers.If the name is null for a Machine context type, this is the local machine name. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.This parameter cannot be null for ApplicationDirectory context types.

container
String String String

Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll.The container on the store to use as the root of the context. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.All queries are performed under this root, and all inserts are performed into this container.

Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.For Machine context types, this parameter must be set to null.

userName
String String String

Der Benutzername zum Herstellen einer Verbindung mit dem Speicher.The username used to connect to the store. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet.If the userName and password parameters are both null, the default credentials of the current principal are used. 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.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

password
String String String

Das Kennwort, das verwendet wird, um eine Verbindung mit dem Speicher herzustellen.The password used to connect to the store. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet.If the userName and password parameters are both null, the default credentials of the current principal are used. 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.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

Ausnahmen

Der username-Parameter und der password-Parameter müssen entweder null sein oder einen Wert enthalten.The username and password parameters must either be null or contain a value.

Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Ein name oder ein container muss angegeben werden, wenn ApplicationDirectory im contextType-Parameter angegeben wird.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.The contextType parameter does not contain a valid ContextType enumeration value.

Hinweise

Kann in nachfolgenden Verzeichnis Vorgangs aufrufen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der Domain für einen Prinzipal Kontext angegebene Container kein gültiger Container ist. InvalidOperationExceptionThe InvalidOperationException may be thrown in subsequent directory operations calls that connect to the server if the container specified for a Domain principal context is not a valid container. Ein Container ist als ein Objekt definiert, dessen Schema Klasse die Prinzipal Klassen (Benutzer, Gruppe oder Computer) im Attribut "PossibleInferiors" enthält.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

PrincipalContext(ContextType, String, String, ContextOptions, String, String) PrincipalContext(ContextType, String, String, ContextOptions, String, String) 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.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, context options, username, and password.

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.PrincipalContext

Parameter

contextType
ContextType ContextType ContextType

Ein ContextType-Enumerationswert, der den Speichertyp für den Prinzipalkontext angibt.A ContextType enumeration value specifying the type of store for the principal context.

name
String String 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.The name of the domain or server for Domain context types, the machine name for Machine context types, or the name of the server and port hosting the ApplicationDirectory instance.

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.If the name is null for a Domain context type this context is a domain controller for the domain of the user principal under which the thread is running. Wenn der Name für einen Machine-Kontexttyp null lautet, ist dies der Name des lokalen Computers.If the name is null for a Machine context type, this is the local machine name. Dieser Parameter kann für ApplicationDirectory-Kontexttypen nicht null sein.This parameter cannot be null for ApplicationDirectory context types.

container
String String String

Der Container für den Speicher, der als Stamm des Kontexts verwendet werden soll.The container on the store to use as the root of the context. Alle Abfragen erfolgen unter diesem Stammort, und alle Einfügevorgänge werden in diesem Container ausgeführt.All queries are performed under this root, and all inserts are performed into this container.

Bei Domain- und ApplicationDirectory-Kontexttypen stellt dieser Parameter den Distinguished Name eines Containerobjekts dar.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Bei Machine-Kontexttypen muss dieser Parameter auf null festgelegt werden.For Machine context types, this parameter must be set to null.

options
ContextOptions ContextOptions ContextOptions

Eine Kombination aus einem oder mehreren ContextOptions-Enumerationswerten, die die Optionen für die Serverbindung angeben.A combination of one or more ContextOptions enumeration values the options used to bind to the server. Wenn dieser Parameter null ist, sind die Standardoptionen ContextOptions.Negotiate, ContextOptions.Signing und ContextOptions.Sealing.If this parameter is null, the default options are ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

userName
String String String

Der Benutzername zum Herstellen einer Verbindung mit dem Speicher.The username used to connect to the store. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet.If the userName and password parameters are both null, the default credentials of the current principal are used. 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.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

password
String String String

Das Kennwort, das verwendet wird, um eine Verbindung mit dem Speicher herzustellen.The password used to connect to the store. Wenn der userName-Parameter und der password-Parameter null sind, werden die Standardanmeldeinformationen des aktuellen Prinzipals verwendet.If the userName and password parameters are both null, the default credentials of the current principal are used. 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.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

Ausnahmen

Der username-Parameter und der password-Parameter müssen entweder null sein oder einen Wert enthalten.The username and password parameters must either be null or contain a value.

Wenn der Machine-Kontexttyp im contextType-Parameter angegeben wird, kann kein Container angegeben werden.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Wenn ApplicationDirectory im contextType-Parameter angegeben wird, muss ein Name oder ein Container angegeben werden.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

Der contextType-Parameter enthält keinen gültigen ContextType-Enumerationswert.The contextType parameter does not contain a valid ContextType enumeration value.

Der options-Parameter enthält keine Kombination aus gültigen ContextOptions-Enumerationswerten.The options parameter does not contain a combination of valid ContextOptions enumeration values.

Hinweise

Kann in nachfolgenden Verzeichnis Vorgangs aufrufen ausgelöst werden, die eine Verbindung mit dem Server herstellen, wenn der Domain für einen Prinzipal Kontext angegebene Container kein gültiger Container ist. InvalidOperationExceptionThe InvalidOperationException may be thrown in subsequent directory operations calls that connect to the server if the container specified for a Domain principal context is not a valid container. Ein Container ist als ein Objekt definiert, dessen Schema Klasse die Prinzipal Klassen (Benutzer, Gruppe oder Computer) im Attribut "PossibleInferiors" enthält.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

Gilt für: