DirectoryContext Classe
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.
A DirectoryContext classe identifica um diretório específico e as credenciais que são usadas para aceder ao diretório.
public ref class DirectoryContext
public class DirectoryContext
type DirectoryContext = class
Public Class DirectoryContext
- Herança
-
DirectoryContext
Observações
Um contexto de diretório deve ser criado antes de aceder aos métodos e propriedades de um objeto de diretório System.DirectoryServices.ActiveDirectory, como um domínio ou floresta.
Ao criar um contexto de diretório, as credenciais atuais do processo ou credenciais alternativas podem ser aplicadas a esse contexto usando o construtor apropriado. Estas credenciais determinam as permissões que entram em vigor quando o programa acede a objetos de diretório. Como os objetos do Active Directory Domain Services podem ser protegidos contra recuperação ou modificação por utilizadores não administrativos, o uso de credenciais alternativas com permissão para aceder aos objetos-alvo é por vezes necessário para a correta funcionalidade do programa.
A tabela seguinte contém uma lista dos tipos de alvo permitidos e uma descrição do formato da cadeia de alvo.
| Tipo de destino | DirectoryContextType Membro | Formato do nome alvo |
|---|---|---|
| Controlador de Domínio | DirectoryServer | O nome DNS do controlador de domínio. |
| Instância LDS AD | DirectoryServer | O nome DNS do servidor AD LDS e o número da porta LDAP, por exemplo, ad_lds_instance.fabrikam.com:389. |
| Domínio | Domain | O nome DNS do domínio, por exemplo, sales.corp.fabrikam.com. |
| Forest | Forest | O nome DNS da floresta, por exemplo, corp.fabrikam.com. |
| Partição da Aplicação | ApplicationPartition | O nome DNS da partição da aplicação. |
| Conjunto de Configuração AD LDS | ConfigurationSet | Uma das palavras-chave associada ao ponto de ligação de serviço registado pelas instâncias AD LDS para o conjunto de configuração. |
Construtores
| Name | Description |
|---|---|
| DirectoryContext(DirectoryContextType, String, String, String) |
Inicializa uma nova instância da DirectoryContext classe do tipo especificado que contém o destino, nome de utilizador e palavra-passe especificados. |
| DirectoryContext(DirectoryContextType, String, String) |
Inicializa uma nova instância da DirectoryContext classe do tipo especificado que contém o nome de utilizador e a palavra-passe especificados. |
| DirectoryContext(DirectoryContextType, String) |
Inicializa uma nova instância da DirectoryContext classe do tipo especificado que contém o nome especificado e as credenciais do contexto de utilizador atual. |
| DirectoryContext(DirectoryContextType) |
Inicializa uma nova instância da DirectoryContext classe do tipo especificado que contém as credenciais do contexto do utilizador atual. |
Propriedades
| Name | Description |
|---|---|
| ContextType |
Obtém o tipo do objeto de contexto. |
| Name |
Percebe o nome do contexto. |
| UserName |
Obtém o nome de utilizador do contexto. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |