PrincipalContext Construtores

Definição

Inicializa uma nova instância da classe PrincipalContext.Initializes a new instance of the PrincipalContext class.

Sobrecargas

PrincipalContext(ContextType)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto especificado.Initializes a new instance of the PrincipalContext class with the specified context type.

PrincipalContext(ContextType, String)

Inicializa uma nova instância da classe PrincipalContext com o tipo e nome de contexto especificados.Initializes a new instance of the PrincipalContext class with the specified context type and name.

PrincipalContext(ContextType, String, String)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome e o contêiner especificados.Initializes a new instance of the PrincipalContext class with the specified context type, name, and container.

PrincipalContext(ContextType, String, String, ContextOptions)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o contêiner e as opções de contexto especificados.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, and context options.

PrincipalContext(ContextType, String, String, String)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o nome de usuário e a senha especificados.Initializes a new instance of the PrincipalContext class with the specified context type, name, username, and password.

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

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o contêiner, o nome de usuário e a senha especificados.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)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o contêiner, as opções de contexto, o nome de usuário e a senha especificados.Initializes a new instance of the PrincipalContext class with the specified context type, name, container, context options, username, and password.

Comentários

Os PrincipalContext construtores executam a validação dos parâmetros e do servidor, mas não tentam validar as credenciais.The PrincipalContext constructors perform validation of the parameters and server, but not do not attempt to validate credentials.

Quando o objeto de contexto principal é criado sem especificar um contêiner, ele pode ser usado para representar vários contêineres distintos.When the principal context object is created without specifying a container, it may be used to represent multiple distinct containers. Um contêiner pode ser usado como a base das operações de consulta, enquanto contêineres adicionais podem conter objetos principais recém-criados.One container may be used as the base of query operations, while additional containers can hold newly-created principal objects. Por exemplo, quando os usuários ou grupos são inseridos no tipo de contexto de domínio, a API de gerenciamento de conta usa o contêiner de usuário conhecido padrão, "CN = Users, DC = Fabrikam, DC = com".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". Quando os computadores são inseridos na loja, a API usa o contêiner "CN = Computers, DC = Fabrikam, DC = com" padrão.When computers are inserted in the store, the API uses the default "CN=Computers,DC=Fabrikam,DC=com" container. Observe que os nomes de contêiner padrão podem ser alterados pelo administrador de domínio.Note that the default container names can be changed by the domain administrator. Como os construtores de objeto principal só podem especificar um contexto de entidade de segurança, contextos adicionais são expostos como o comportamento padrão quando o aplicativo cria um contexto de domínio sem especificar um contêiner.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. Como o diretório do aplicativo não tem contêineres bem conhecidos, o aplicativo deve especificar um contêiner no construtor ou o ArgumentException é gerado.Since the application directory does not have well-known containers, the application must specify a container in the constructor or the ArgumentException is thrown. Como o SAM não tem contêineres, um ArgumentException será gerado se o aplicativo tentar especificar um contêiner no construtor.Since SAM does not have containers, a ArgumentException is thrown if the application attempts to specify a container in the constructor.

Em cada versão do construtor que usa um nome de usuário como parâmetro, a userName cadeia de caracteres pode estar em vários formatos diferentes.In each version of the constructor that takes a user name as a parameter, the userName string can be in various different formats. Os três NameFormats com suporte para são Nt4Name, UserPrincipalName e SamAccountName.The three supported NameFormats for are Nt4Name, UserPrincipalName, and SamAccountName. Para obter mais informações sobre formatos de nome, consulte a documentação do ADS_NAME_TYPE_ENUM aqui.For more information about name formats, see the ADS_NAME_TYPE_ENUM documentation here.

PrincipalContext(ContextType)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto especificado.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
Public Sub New (contextType As ContextType)

Parâmetros

contextType
ContextType

Um valor de enumeração ContextType que especifica o tipo de repositório para o contexto da entidade de segurança.A ContextType enumeration value specifying the type of store for the principal context.

Exceções

Um nome ou contêiner deve ser especificado ao usar o contexto do diretório do aplicativo.A name or container must be specified when using the application directory context.

O parâmetro contextType não contém um valor de enumeração ContextType válido.The contextType parameter does not contain a valid ContextType enumeration value.

Aplica-se a

PrincipalContext(ContextType, String)

Inicializa uma nova instância da classe PrincipalContext com o tipo e nome de contexto especificados.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
Public Sub New (contextType As ContextType, name As String)

Parâmetros

contextType
ContextType

Um valor de enumeração ContextType que especifica o tipo de repositório para o contexto da entidade de segurança.A ContextType enumeration value specifying the type of store for the principal context.

name
String

O nome do domínio ou do servidor dos tipos de contexto de Domain, o nome do computador do tipos de contexto de Machine ou o nome do servidor e da porta que hospedam a instância ApplicationDirectory.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.

Se o nome for null para um tipo de contexto de Domain, esse contexto será um controlador de domínio do domínio da entidade de segurança de usuário no qual o thread é executado.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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local.If the name is null for a Machine context type, this is the local machine name. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.This parameter cannot be null for ApplicationDirectory context types.

Exceções

Um nome deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.A name must be specified when ApplicationDirectory is specified in the contextType parameter.

O parâmetro contextType não contém um valor de enumeração ContextType válido.The contextType parameter does not contain a valid ContextType enumeration value.

Aplica-se a

PrincipalContext(ContextType, String, String)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome e o contêiner especificados.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
Public Sub New (contextType As ContextType, name As String, container As String)

Parâmetros

contextType
ContextType

Um valor de enumeração ContextType que especifica o tipo de repositório para o contexto da entidade de segurança.A ContextType enumeration value specifying the type of store for the principal context.

name
String

O nome do domínio ou do servidor dos tipos de contexto de Domain, o nome do computador do tipos de contexto de Machine ou o nome do servidor e da porta que hospedam a instância ApplicationDirectory.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.

Se o nome for null para um tipo de contexto de Domain, esse contexto será um controlador de domínio do domínio da entidade de segurança de usuário no qual o thread é executado.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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local.If the name is null for a Machine context type, this is the local machine name. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.This parameter cannot be null for ApplicationDirectory context types.

container
String

O contêiner no repositório a ser usado como a raiz do contexto.The container on the store to use as the root of the context. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.All queries are performed under this root, and all inserts are performed into this container.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.For Machine context types, this parameter must be set to null.

Exceções

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Um nome ou contêiner deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

O parâmetro contextType não contém um valor de enumeração ContextType válido.The contextType parameter does not contain a valid ContextType enumeration value.

Comentários

O InvalidOperationException pode ser gerado em chamadas de operações de diretório subsequentes que se conectam ao servidor se o contêiner especificado para um Domain contexto de entidade de segurança não for um contêiner válido.The 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. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, User, Group ou Computer, em seu atributo possibleInferiors.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

Aplica-se a

PrincipalContext(ContextType, String, String, ContextOptions)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o contêiner e as opções de contexto especificados.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
Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)

Parâmetros

contextType
ContextType

Um valor de enumeração ContextType que especifica o tipo de repositório para o contexto da entidade de segurança.A ContextType enumeration value specifying the type of store for the principal context.

name
String

O nome do domínio ou do servidor dos tipos de contexto de Domain, o nome do computador do tipos de contexto de Machine ou o nome do servidor e da porta que hospedam a instância ApplicationDirectory.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.

Se o nome for null para um tipo de contexto de Domain, esse contexto será um controlador de domínio do domínio da entidade de segurança de usuário no qual o thread é executado.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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local.If the name is null for a Machine context type, this is the local machine name. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.This parameter cannot be null for ApplicationDirectory context types.

container
String

O contêiner no repositório a ser usado como a raiz do contexto.The container on the store to use as the root of the context. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.All queries are performed under this root, and all inserts are performed into this container.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.For Machine context types, this parameter must be set to null.

options
ContextOptions

Uma combinação de um ou mais valores de enumeração ContextOptions especificando as opções usadas para associar ao servidor.A combination of one or more ContextOptions enumeration values specifying the options used to bind to the server. Se esse parâmetro for null, as opções padrão serão ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.If this parameter is null, the default options are ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

Exceções

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Um nome ou contêiner deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

O parâmetro contextType não contém um valor de enumeração ContextType válido.The contextType parameter does not contain a valid ContextType enumeration value.

O parâmetro options não contém uma combinação de valores de enumeração ContextOptions válidos.The options parameter does not contain a combination of valid ContextOptions enumeration values.

Comentários

O InvalidOperationException pode ser gerado em chamadas de operações de diretório subsequentes que se conectam ao servidor se o contêiner especificado para um Domain contexto de entidade de segurança não for um contêiner válido.The 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. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, User, Group ou Computer, em seu atributo possibleInferiors.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

Aplica-se a

PrincipalContext(ContextType, String, String, String)

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o nome de usuário e a senha especificados.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
Public Sub New (contextType As ContextType, name As String, userName As String, password As String)

Parâmetros

contextType
ContextType

Um valor de enumeração ContextType que especifica o tipo de repositório para o contexto da entidade de segurança.A ContextType enumeration value specifying the type of store for the principal context.

name
String

O nome do domínio ou do servidor dos tipos de contexto de Domain, o nome do computador do tipos de contexto de Machine ou o nome do servidor e da porta que hospedam a instância ApplicationDirectory.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.

Se o nome for null para um tipo de contexto de Domain, esse contexto será um controlador de domínio do domínio da entidade de segurança de usuário no qual o thread é executado.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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local.If the name is null for a Machine context type, this is the local machine name. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.This parameter cannot be null for ApplicationDirectory context types.

userName
String

O nome de usuário usado para a conexão com o repositório.The username used to connect to the store. Se os parâmetros userName e password forem null, as credenciais do processo atual serão usadas.If the userName and password parameters are both null, the credentials of the current process are used. Caso contrário, userName e password não deverão ser nulos e as credenciais especificadas por eles serão usadas para a conexão com o repositório.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

password
String

A senha usada para a conexão com o repositório.The password used to connect to the store. Se os parâmetros userName e password forem null, as credenciais do processo atual serão usadas.If the userName and password parameters are both null, the credentials of the current process are used. Caso contrário, userName e password não deverão ser nulos e as credenciais especificadas por eles serão usadas para a conexão com o repositório.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

Exceções

Os parâmetros username e password precisam ser nulos ou conter um valor null.The username and password parameters must either be null or contain a value.

Um nome deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.A name must be specified when ApplicationDirectory is specified in the contextType parameter.

O parâmetro contextType não contém um valor de enumeração ContextType válido.The contextType parameter does not contain a valid ContextType enumeration value.

Aplica-se a

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

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o contêiner, o nome de usuário e a senha especificados.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
Public Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)

Parâmetros

contextType
ContextType

Um valor de enumeração ContextType que especifica o tipo de repositório para o contexto da entidade de segurança.A ContextType enumeration value specifying the type of store for the principal context.

name
String

O nome do domínio ou do servidor dos tipos de contexto de Domain, o nome do computador do tipos de contexto de Machine ou o nome do servidor e da porta que hospedam a instância ApplicationDirectory.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.

Se o nome for null para um tipo de contexto de Domain, esse contexto será um controlador de domínio do domínio da entidade de segurança de usuário no qual o thread é executado.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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local.If the name is null for a Machine context type, this is the local machine name. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.This parameter cannot be null for ApplicationDirectory context types.

container
String

O contêiner no repositório a ser usado como a raiz do contexto.The container on the store to use as the root of the context. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.All queries are performed under this root, and all inserts are performed into this container.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.For Machine context types, this parameter must be set to null.

userName
String

O nome de usuário usado para a conexão com o repositório.The username used to connect to the store. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual.If the userName and password parameters are both null, the default credentials of the current principal are used. Caso contrário, userName e password não deverão ser nulos e as credenciais especificadas por eles serão usadas para a conexão com o repositório.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

password
String

A senha usada para a conexão com o repositório.The password used to connect to the store. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual.If the userName and password parameters are both null, the default credentials of the current principal are used. Caso contrário, userName e password não deverão ser nulos e as credenciais especificadas por eles serão usadas para a conexão com o repositório.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

Exceções

Os parâmetros username e password precisam ser nulos ou conter um valor null.The username and password parameters must either be null or contain a value.

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Um name ou container deve ser especificado quando ApplicationDirectory é especificado no parâmetro contextType.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

O parâmetro contextType não contém um valor de enumeração ContextType válido.The contextType parameter does not contain a valid ContextType enumeration value.

Comentários

O InvalidOperationException pode ser gerado em chamadas de operações de diretório subsequentes que se conectam ao servidor se o contêiner especificado para um Domain contexto de entidade de segurança não for um contêiner válido.The 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. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, User, Group ou Computer, em seu atributo possibleInferiors.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

Aplica-se a

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

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o contêiner, as opções de contexto, o nome de usuário e a senha especificados.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
Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions, userName As String, password As String)

Parâmetros

contextType
ContextType

Um valor de enumeração ContextType que especifica o tipo de repositório para o contexto da entidade de segurança.A ContextType enumeration value specifying the type of store for the principal context.

name
String

O nome do domínio ou do servidor dos tipos de contexto de Domain, o nome do computador do tipos de contexto de Machine ou o nome do servidor e da porta que hospedam a instância ApplicationDirectory.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.

Se o nome for null para um tipo de contexto de Domain, esse contexto será um controlador de domínio do domínio da entidade de segurança de usuário no qual o thread é executado.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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local.If the name is null for a Machine context type, this is the local machine name. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.This parameter cannot be null for ApplicationDirectory context types.

container
String

O contêiner no repositório a ser usado como a raiz do contexto.The container on the store to use as the root of the context. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.All queries are performed under this root, and all inserts are performed into this container.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.For Domain and ApplicationDirectory context types, this parameter is the distinguished name of a container object.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.For Machine context types, this parameter must be set to null.

options
ContextOptions

Uma combinação de um ou mais valores de enumeração ContextOptions que as opções usaram para associar ao servidor.A combination of one or more ContextOptions enumeration values the options used to bind to the server. Se esse parâmetro for null, as opções padrão serão ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.If this parameter is null, the default options are ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

userName
String

O nome de usuário usado para a conexão com o repositório.The username used to connect to the store. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual.If the userName and password parameters are both null, the default credentials of the current principal are used. Caso contrário, userName e password não deverão ser nulos e as credenciais especificadas por eles serão usadas para a conexão com o repositório.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

password
String

A senha usada para a conexão com o repositório.The password used to connect to the store. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual.If the userName and password parameters are both null, the default credentials of the current principal are used. Caso contrário, userName e password não deverão ser nulos e as credenciais especificadas por eles serão usadas para a conexão com o repositório.Otherwise, both userName and password must be non-null, and the credentials they specify are used to connect to the store.

Exceções

Os parâmetros username e password precisam ser nulos ou conter um valor null.The username and password parameters must either be null or contain a value.

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.A container cannot be specified when the Machine context type is specified in the contextType parameter.

Um nome ou contêiner deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.A name or container must be specified when ApplicationDirectory is specified in the contextType parameter.

O parâmetro contextType não contém um valor de enumeração ContextType válido.The contextType parameter does not contain a valid ContextType enumeration value.

O parâmetro options não contém uma combinação de valores de enumeração ContextOptions válidos.The options parameter does not contain a combination of valid ContextOptions enumeration values.

Comentários

O InvalidOperationException pode ser gerado em chamadas de operações de diretório subsequentes que se conectam ao servidor se o contêiner especificado para um Domain contexto de entidade de segurança não for um contêiner válido.The 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. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, User, Group ou Computer, em seu atributo possibleInferiors.A container is defined as an object whose schema class has the principal classes, either user, group, or computer, in its possibleInferiors attribute.

Aplica-se a