PrincipalContext Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicializa uma nova instância da PrincipalContext classe.
Sobrecargas
| Nome | Descrição |
|---|---|
| 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 nome especificados. |
| PrincipalContext(ContextType, String, String) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto, nome e contentor especificados. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto especificado, nome, contentor e opções de contexto. |
| PrincipalContext(ContextType, String, String, String) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto, nome, nome de utilizador e palavra-passe especificados. |
| PrincipalContext(ContextType, String, String, String, String) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto, nome, contentor, nome de utilizador e palavra-passe especificados. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Inicializa uma nova instância da PrincipalContext classe com o tipo de contexto especificado, nome, contentor, opções de contexto, nome de utilizador e palavra-passe. |
Observações
Os PrincipalContext construtores realizam a validação dos parâmetros e do servidor, mas não tentam validar credenciais.
Quando o objeto de contexto principal é criado sem especificar um contentor, pode ser usado para representar múltiplos recipientes distintos. Um contentor pode ser usado como base para operações de consulta, enquanto contentores adicionais podem conter objetos principais recém-criados. Por exemplo, quando utilizadores ou grupos são inseridos no tipo de contexto do domínio, a API de Gestão de Contas utiliza o contentor de utilizador conhecido por defeito, "CN=Users,DC=Fabrikam,DC=com". Quando os computadores são inseridos na loja, a API utiliza o contentor padrão "CN=Computers,DC=Fabrikam,DC=com". Note que os nomes dos contentores por defeito podem ser alterados pelo administrador do domínio. Como os construtores principais de objetos só podem especificar um contexto principal, contextos adicionais são expostos como comportamento padrão quando a aplicação cria um contexto de domínio sem especificar um contentor. Como o diretório da aplicação não possui contentores bem conhecidos, a aplicação deve especificar um contentor no construtor ou o ArgumentException é lançado. Como o SAM não tem contentores, a ArgumentException é lançado se a aplicação tentar especificar um contentor no construtor.
Em cada versão do construtor que toma um nome de utilizador como parâmetro, a userName cadeia pode estar em vários formatos diferentes. Os três NameFormats suportados são Nt4Name, UserPrincipalName e SamAccountName. Para mais informações sobre formatos de nomes, consulte a documentação 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 armazenamento para o contexto principal.
Exceções
Um nome ou contentor deve ser especificado ao utilizar o contexto do diretório da aplicação.
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 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 armazenamento para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome da máquina para Machine tipos de contexto, ou o nome do servidor e porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto é um controlador de domínio para o domínio do principal de utilizador sob o qual a thread está a correr. Se o nome for null para um Machine tipo de contexto, este é o nome local da máquina. Este 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, nome e contentor 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 armazenamento para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome da máquina para Machine tipos de contexto, ou o nome do servidor e porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto é um controlador de domínio para o domínio do principal de utilizador sob o qual a thread está a correr. Se o nome for null para um Machine tipo de contexto, este é o nome local da máquina. Este parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- container
- String
O contentor na loja para usar como raiz do contexto. Todas as consultas são realizadas sob esta raiz, e todas as inserções são feitas neste contentor.
Para Domain e ApplicationDirectory tipos de contexto, este parâmetro é o nome distinto de um objeto contentor.
Para Machine tipos de contexto, este parâmetro deve ser definido como null.
Exceções
Um contentor não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
Um nome ou contentor 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 .
Observações
Podem InvalidOperationException ser inseridas em chamadas subsequentes de operações de diretório que se ligam ao servidor se o contentor especificado para um Domain contexto principal não for válido. Um contentor é definido como um objeto cuja classe de esquema tem as classes principais, seja utilizador, grupo ou computador, no 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 especificado, nome, contentor e opções de contexto.
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 armazenamento para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome da máquina para Machine tipos de contexto, ou o nome do servidor e porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto é um controlador de domínio para o domínio do principal de utilizador sob o qual a thread está a correr. Se o nome for null para um Machine tipo de contexto, este é o nome local da máquina. Este parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- container
- String
O contentor na loja para usar como raiz do contexto. Todas as consultas são realizadas sob esta raiz, e todas as inserções são feitas neste contentor.
Para Domain e ApplicationDirectory tipos de contexto, este parâmetro é o nome distinto de um objeto contentor.
Para Machine tipos de contexto, este parâmetro deve ser definido como null.
- options
- ContextOptions
Uma combinação de um ou mais ContextOptions valores de enumeração que especificam as opções usadas para se ligar ao servidor. Se este parâmetro for null, as opções padrão são ContextOptions.Negotiate | ContextOptions.Assinatura | ContextOpções. Selado.
Exceções
Um contentor não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
Um nome ou contentor 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 válidos ContextOptions de enumeração.
Observações
Podem InvalidOperationException ser inseridas em chamadas subsequentes de operações de diretório que se ligam ao servidor se o contentor especificado para um Domain contexto principal não for válido. Um contentor é definido como um objeto cuja classe de esquema tem as classes principais, seja utilizador, grupo ou computador, no 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, nome, nome de utilizador e palavra-passe 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 armazenamento para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome da máquina para Machine tipos de contexto, ou o nome do servidor e porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto é um controlador de domínio para o domínio do principal de utilizador sob o qual a thread está a correr. Se o nome for null para um Machine tipo de contexto, este é o nome local da máquina. Este parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- userName
- String
O nome de utilizador usado para ligar à loja. Se os userName parâmetros e password forem ambos null, são usadas as credenciais do processo atual. Caso contrário, tanto userName como password devem ser não-nulos, e as credenciais que especificam são usadas para se ligar à loja.
- password
- String
A palavra-passe usada para ligar à loja. Se os userName parâmetros e password forem ambos null, são usadas as credenciais do processo atual. Caso contrário, tanto userName como password devem ser não-nulos, e as credenciais que especificam são usadas para se ligar à loja.
Exceções
Os userName parâmetros e password devem 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, nome, contentor, nome de utilizador e palavra-passe 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 armazenamento para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome da máquina para Machine tipos de contexto, ou o nome do servidor e porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto é um controlador de domínio para o domínio do principal de utilizador sob o qual a thread está a correr. Se o nome for null para um Machine tipo de contexto, este é o nome local da máquina. Este parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- container
- String
O contentor na loja para usar como raiz do contexto. Todas as consultas são realizadas sob esta raiz, e todas as inserções são feitas neste contentor.
Para Domain e ApplicationDirectory tipos de contexto, este parâmetro é o nome distinto de um objeto contentor.
Para Machine tipos de contexto, este parâmetro deve ser definido como null.
- userName
- String
O nome de utilizador usado para ligar à loja. Se os userName parâmetros e password forem ambos null, são usadas as credenciais padrão do principal atual. Caso contrário, tanto userName como password devem ser não-nulos, e as credenciais que especificam são usadas para se ligar à loja.
- password
- String
A palavra-passe usada para ligar à loja. Se os userName parâmetros e password forem ambos null, são usadas as credenciais padrão do principal atual. Caso contrário, tanto userName como password devem ser não-nulos, e as credenciais que especificam são usadas para se ligar à loja.
Exceções
Os userName parâmetros e password devem ser null ou conter um valor.
Um contentor não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
A 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 .
Observações
Podem InvalidOperationException ser inseridas em chamadas subsequentes de operações de diretório que se ligam ao servidor se o contentor especificado para um Domain contexto principal não for válido. Um contentor é definido como um objeto cuja classe de esquema tem as classes principais, seja utilizador, grupo ou computador, no 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 especificado, nome, contentor, opções de contexto, nome de utilizador e palavra-passe.
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 armazenamento para o contexto principal.
- name
- String
O nome do domínio ou servidor para Domain tipos de contexto, o nome da máquina para Machine tipos de contexto, ou o nome do servidor e porta que hospeda a ApplicationDirectory instância.
Se o nome for null para um Domain tipo de contexto, esse contexto é um controlador de domínio para o domínio do principal de utilizador sob o qual a thread está a correr. Se o nome for null para um Machine tipo de contexto, este é o nome local da máquina. Este parâmetro não pode ser null para ApplicationDirectory tipos de contexto.
- container
- String
O contentor na loja para usar como raiz do contexto. Todas as consultas são realizadas sob esta raiz, e todas as inserções são feitas neste contentor.
Para Domain e ApplicationDirectory tipos de contexto, este parâmetro é o nome distinto de um objeto contentor.
Para Machine tipos de contexto, este parâmetro deve ser definido como null.
- options
- ContextOptions
Uma combinação de um ou mais ContextOptions valores de enumeração das opções usadas para se ligar ao servidor. Se este parâmetro for null, as opções padrão são ContextOptions.Negotiate | ContextOptions.Assinatura | ContextOpções. Selado.
- userName
- String
O nome de utilizador usado para ligar à loja. Se os userName parâmetros e password forem ambos null, são usadas as credenciais padrão do principal atual. Caso contrário, tanto userName como password devem ser não-nulos, e as credenciais que especificam são usadas para se ligar à loja.
- password
- String
A palavra-passe usada para ligar à loja. Se os userName parâmetros e password forem ambos null, são usadas as credenciais padrão do principal atual. Caso contrário, tanto userName como password devem ser não-nulos, e as credenciais que especificam são usadas para se ligar à loja.
Exceções
Os userName parâmetros e password devem ser null ou conter um valor.
Um contentor não pode ser especificado quando o Machine tipo de contexto é especificado no contextType parâmetro.
Um nome ou contentor 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 válidos ContextOptions de enumeração.
Observações
Podem InvalidOperationException ser inseridas em chamadas subsequentes de operações de diretório que se ligam ao servidor se o contentor especificado para um Domain contexto principal não for válido. Um contentor é definido como um objeto cuja classe de esquema tem as classes principais, seja utilizador, grupo ou computador, no seu atributo possibleInferiors.
