PrincipalContext Construtores

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Inicializa uma nova instância da classe PrincipalContext.

Sobrecargas

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

Comentários

Os PrincipalContext construtores executam a validação dos parâmetros e do servidor, mas não tentam validar as credenciais.

Quando o objeto de contexto principal é criado sem especificar um contêiner, ele pode ser usado para representar vários contêineres distintos. Um contêiner pode ser usado como base de operações de consulta, enquanto contêineres adicionais podem conter objetos de entidade de segurança recém-criados. Por exemplo, quando 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". Quando os computadores são inseridos no repositório, a API usa o contêiner padrão "CN=Computers,DC=Fabrikam,DC=com". Observe que os nomes de contêiner padrão podem ser alterados pelo administrador de domínio. Como os construtores de objeto principal só podem especificar um contexto principal, contextos adicionais são expostos como o comportamento padrão quando o aplicativo cria um contexto de domínio sem especificar um contêiner. Como o diretório do aplicativo não tem contêineres conhecidos, o aplicativo deve especificar um contêiner no construtor ou o ArgumentException é gerado. Como o SAM não tem contêineres, um ArgumentException será gerado se o aplicativo tentar especificar um contêiner no construtor.

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. Os três NameFormats com suporte para são Nt4Name, UserPrincipalName e SamAccountName. Para obter mais informações sobre formatos de nome, consulte a documentação do ADS_NAME_TYPE_ENUM.

PrincipalContext(ContextType)

Origem:

Context.cs

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto especificado.

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.

Exceções

ArgumentException

Um nome ou contêiner deve ser especificado ao usar o contexto do diretório do aplicativo.

InvalidEnumArgumentException

O parâmetro contextType não contém um valor de enumeração ContextType válido.

PrincipalContext(ContextType, String)

Origem:

Context.cs

Inicializa uma nova instância da classe PrincipalContext com o tipo e nome de contexto especificados.

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.

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.

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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.

Exceções

ArgumentException

Um nome deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.

InvalidEnumArgumentException

O parâmetro contextType não contém um valor de enumeração ContextType válido.

PrincipalContext(ContextType, String, String)

Origem:

Context.cs

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome e o contêiner especificados.

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.

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.

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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.

container

String

O contêiner no repositório a ser usado como a raiz do contexto. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.

Exceções

ArgumentException

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.

Um nome ou contêiner deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.

InvalidEnumArgumentException

O parâmetro contextType não contém um valor de enumeração ContextType válido.

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 principal não for um contêiner válido. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, usuário, grupo ou computador, em seu atributo possibleInferiors.

PrincipalContext(ContextType, String, String, ContextOptions)

Origem:

Context.cs

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.

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.

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.

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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.

container

String

O contêiner no repositório a ser usado como a raiz do contexto. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.

options

ContextOptions

Uma combinação de um ou mais valores de enumeração ContextOptions especificando as opções usadas para associar ao servidor. Se esse parâmetro for null, as opções padrão serão ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

Exceções

ArgumentException

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.

Um nome ou contêiner deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.

InvalidEnumArgumentException

O parâmetro contextType não contém um valor de enumeração ContextType válido.

O parâmetro options não contém uma combinação de valores de enumeração ContextOptions válidos.

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 principal não for um contêiner válido. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, usuário, grupo ou computador, em seu atributo possibleInferiors.

PrincipalContext(ContextType, String, String, String)

Origem:

Context.cs

Inicializa uma nova instância da classe PrincipalContext com o tipo de contexto, o nome, o nome de usuário e a senha especificados.

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.

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.

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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.

userName

String

O nome de usuário usado para a conexão com o repositório. Se os parâmetros userName e password forem null, as credenciais do processo atual serão usadas. 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.

password

String

A senha usada para a conexão com o repositório. Se os parâmetros userName e password forem null, as credenciais do processo atual serão usadas. 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.

Exceções

ArgumentException

Os parâmetros username e password precisam ser nulos ou conter um valor null.

Um nome deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.

InvalidEnumArgumentException

O parâmetro contextType não contém um valor de enumeração ContextType válido.

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

Origem:

Context.cs

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.

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.

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.

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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.

container

String

O contêiner no repositório a ser usado como a raiz do contexto. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.

userName

String

O nome de usuário usado para a conexão com o repositório. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual. 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.

password

String

A senha usada para a conexão com o repositório. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual. 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.

Exceções

ArgumentException

Os parâmetros username e password precisam ser nulos ou conter um valor null.

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.

Um name ou container deve ser especificado quando ApplicationDirectory é especificado no parâmetro contextType.

InvalidEnumArgumentException

O parâmetro contextType não contém um valor de enumeração ContextType válido.

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 principal não for um contêiner válido. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, usuário, grupo ou computador, em seu atributo possibleInferiors.

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

Origem:

Context.cs

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.

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.

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.

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. Se o nome for null para um tipo de contexto de Machine, esse será o nome do computador local. Esse parâmetro não pode ser null para tipos de contexto ApplicationDirectory.

container

String

O contêiner no repositório a ser usado como a raiz do contexto. Todas as consultas são executadas nessa raiz e todas as inserções são executadas nesse contêiner.

Para os tipos de contexto Domain e ApplicationDirectory, esse parâmetro é o nome diferenciado de um objeto de contêiner.

Para os tipos de contexto Machine, esse parâmetro deve ser definido como null.

options

ContextOptions

Uma combinação de um ou mais valores de enumeração ContextOptions que as opções usaram para associar ao servidor. Se esse parâmetro for null, as opções padrão serão ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

userName

String

O nome de usuário usado para a conexão com o repositório. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual. 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.

password

String

A senha usada para a conexão com o repositório. Se os parâmetros userName e password forem null, serão usadas as credenciais padrão da entidade de segurança atual. 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.

Exceções

ArgumentException

Os parâmetros username e password precisam ser nulos ou conter um valor null.

Um contêiner não pode ser especificado quando o tipo de contexto Machine é especificado no parâmetro contextType.

Um nome ou contêiner deverá ser especificado quando ApplicationDirectory for especificado no parâmetro contextType.

InvalidEnumArgumentException

O parâmetro contextType não contém um valor de enumeração ContextType válido.

O parâmetro options não contém uma combinação de valores de enumeração ContextOptions válidos.

Comentários

O InvalidOperationException poderá 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. Um contêiner é definido como um objeto cuja classe de esquema tem as classes principais, usuário, grupo ou computador, em seu atributo possibleInferiors.