PrincipalContext Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe PrincipalContext.
Sobrecargas
| Nome | Description |
|---|---|
| PrincipalContext(ContextType) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto especificado. |
| PrincipalContext(ContextType, String) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto e o nome especificados. |
| PrincipalContext(ContextType, String, String) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto, o nome e o contêiner especificados. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Inicializa uma nova instância da PrincipalContext classe 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 PrincipalContext classe 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 PrincipalContext classe 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 PrincipalContext classe 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 é 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 compatíveis 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
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
Inicializa uma nova instância da PrincipalContext classe 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.PrincipalContextPublic Sub New (contextType As ContextType)Parâmetros
- contextType
- ContextType
Um ContextType valor de enumeração que especifica o tipo de repositório para o contexto principal.
Exceções
Um nome ou contêiner deve ser especificado ao usar o contexto do diretório do aplicativo.
O contextType parâmetro não contém um valor de enumeração válido ContextType .
Aplica-se a
PrincipalContext(ContextType, String)
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto e o nome 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String)Parâmetros
- contextType
- ContextType
Um ContextType valor de enumeração que especifica o tipo de repositório para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome do computador para Machine tipos de contexto ou o nome do servidor e da porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto será um controlador de domínio para o domínio da entidade de segurança do usuário sob o qual o thread está sendo executado. Se o nome for null para um Machine tipo de contexto, esse será o nome do computador local. Esse parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
Exceções
Um nome deve ser especificado quando ApplicationDirectory é especificado no contextType parâmetro.
O contextType parâmetro não contém um valor de enumeração válido ContextType .
Aplica-se a
PrincipalContext(ContextType, String, String)
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
Inicializa uma nova instância da PrincipalContext classe 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String)Parâmetros
- contextType
- ContextType
Um ContextType valor de enumeração que especifica o tipo de repositório para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome do computador para Machine tipos de contexto ou o nome do servidor e da porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto será um controlador de domínio para o domínio da entidade de segurança do usuário sob o qual o thread está sendo executado. Se o nome for null para um Machine tipo de contexto, esse será o nome do computador local. Esse parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- 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 Domain e ApplicationDirectory tipos de contexto, esse parâmetro é o nome diferenciado de um objeto de contêiner.
Para Machine tipos de contexto, esse parâmetro deve ser definido como null.
Exceções
Um contêiner não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
Um nome ou contêiner deve ser especificado quando ApplicationDirectory é especificado no contextType parâmetro.
O contextType parâmetro não contém um valor de enumeração válido ContextType .
Comentários
O InvalidOperationException valor 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 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.
Aplica-se a
PrincipalContext(ContextType, String, String, ContextOptions)
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
Inicializa uma nova instância da PrincipalContext classe 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)Parâmetros
- contextType
- ContextType
Um ContextType valor de enumeração que especifica o tipo de repositório para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome do computador para Machine tipos de contexto ou o nome do servidor e da porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto será um controlador de domínio para o domínio da entidade de segurança do usuário sob o qual o thread está sendo executado. Se o nome for null para um Machine tipo de contexto, esse será o nome do computador local. Esse parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- 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 Domain e ApplicationDirectory tipos de contexto, esse parâmetro é o nome diferenciado de um objeto de contêiner.
Para Machine tipos de contexto, esse parâmetro deve ser definido como null.
- options
- ContextOptions
Uma combinação de um ou mais ContextOptions valores de enumeração 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
Um contêiner não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
Um nome ou contêiner deve ser especificado quando ApplicationDirectory é especificado no contextType parâmetro.
O contextType parâmetro não contém um valor de enumeração válido ContextType .
O options parâmetro não contém uma combinação de valores de enumeração válidos ContextOptions .
Comentários
O InvalidOperationException valor 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 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.
Aplica-se a
PrincipalContext(ContextType, String, String, String)
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
Inicializa uma nova instância da PrincipalContext classe 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, userName As String, password As String)Parâmetros
- contextType
- ContextType
Um ContextType valor de enumeração que especifica o tipo de repositório para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome do computador para Machine tipos de contexto ou o nome do servidor e da porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto será um controlador de domínio para o domínio da entidade de segurança do usuário sob o qual o thread está sendo executado. Se o nome for null para um Machine tipo de contexto, esse será o nome do computador local. Esse parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- userName
- String
O nome de usuário usado para se conectar ao repositório. Se os parâmetros e userName os password parâmetros forem ambosnull, as credenciais do processo atual serão usadas. Caso contrário, ambos userName e password devem ser não nulos e as credenciais especificadas serão usadas para se conectar ao repositório.
- password
- String
A senha usada para se conectar ao repositório. Se os parâmetros e userName os password parâmetros forem ambosnull, as credenciais do processo atual serão usadas. Caso contrário, ambos userName e password devem ser não nulos e as credenciais especificadas serão usadas para se conectar ao repositório.
Exceções
O userName parâmetro e password deve ser null ou conter um valor.
Um nome deve ser especificado quando ApplicationDirectory é especificado no contextType parâmetro.
O contextType parâmetro não contém um valor de enumeração válido ContextType .
Aplica-se a
PrincipalContext(ContextType, String, String, String, String)
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
Inicializa uma nova instância da PrincipalContext classe 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)Parâmetros
- contextType
- ContextType
Um ContextType valor de enumeração que especifica o tipo de repositório para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome do computador para Machine tipos de contexto ou o nome do servidor e da porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto será um controlador de domínio para o domínio da entidade de segurança do usuário sob o qual o thread está sendo executado. Se o nome for null para um Machine tipo de contexto, esse será o nome do computador local. Esse parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- 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 Domain e ApplicationDirectory tipos de contexto, esse parâmetro é o nome diferenciado de um objeto de contêiner.
Para Machine tipos de contexto, esse parâmetro deve ser definido como null.
- userName
- String
O nome de usuário usado para se conectar ao repositório. Se os parâmetros e userName os password parâmetros forem ambosnull, as credenciais padrão da entidade de segurança atual serão usadas. Caso contrário, ambos userName e password devem ser não nulos e as credenciais especificadas serão usadas para se conectar ao repositório.
- password
- String
A senha usada para se conectar ao repositório. Se os parâmetros e userName os password parâmetros forem ambosnull, as credenciais padrão da entidade de segurança atual serão usadas. Caso contrário, ambos userName e password devem ser não nulos e as credenciais especificadas serão usadas para se conectar ao repositório.
Exceções
O userName parâmetro e password deve ser null ou conter um valor.
Um contêiner não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
Um name ou container deve ser especificado quando ApplicationDirectory é especificado no contextType parâmetro.
O contextType parâmetro não contém um valor de enumeração válido ContextType .
Comentários
O InvalidOperationException valor 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 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.
Aplica-se a
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
- Origem:
- Context.cs
Inicializa uma nova instância da PrincipalContext classe 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.PrincipalContextPublic 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 ContextType valor de enumeração que especifica o tipo de repositório para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome do computador para Machine tipos de contexto ou o nome do servidor e da porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto será um controlador de domínio para o domínio da entidade de segurança do usuário sob o qual o thread está sendo executado. Se o nome for null para um Machine tipo de contexto, esse será o nome do computador local. Esse parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- 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 Domain e ApplicationDirectory tipos de contexto, esse parâmetro é o nome diferenciado de um objeto de contêiner.
Para Machine tipos de contexto, esse parâmetro deve ser definido como null.
- options
- ContextOptions
Uma combinação de um ou mais ContextOptions valores de enumeração 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.
- userName
- String
O nome de usuário usado para se conectar ao repositório. Se os parâmetros e userName os password parâmetros forem ambosnull, as credenciais padrão da entidade de segurança atual serão usadas. Caso contrário, ambos userName e password devem ser não nulos e as credenciais especificadas serão usadas para se conectar ao repositório.
- password
- String
A senha usada para se conectar ao repositório. Se os parâmetros e userName os password parâmetros forem ambosnull, as credenciais padrão da entidade de segurança atual serão usadas. Caso contrário, ambos userName e password devem ser não nulos e as credenciais especificadas serão usadas para se conectar ao repositório.
Exceções
O userName parâmetro e password deve ser null ou conter um valor.
Um contêiner não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
Um nome ou contêiner deve ser especificado quando ApplicationDirectory é especificado no contextType parâmetro.
O contextType parâmetro não contém um valor de enumeração válido ContextType .
O options parâmetro não contém uma combinação de valores de enumeração válidos ContextOptions .
Comentários
O InvalidOperationException valor 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 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.
