DirectoryContext Classe
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.
A classe DirectoryContext identifica um diretório específico e as credenciais usadas para acessar o diretório.
public ref class DirectoryContext
public class DirectoryContext
type DirectoryContext = class
Public Class DirectoryContext
- Herança
-
DirectoryContext
Comentários
Um contexto de diretório deve ser criado antes de acessar os métodos e as 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 ou as credenciais alternativas do processo podem ser aplicadas a esse contexto usando o construtor apropriado. Essas credenciais determinam as permissões que estão em vigor quando o programa acessa objetos de diretório. Como Active Directory Domain Services objetos podem ser protegidos contra recuperação ou modificação por usuários não administrativos, o uso de credenciais alternativas com permissão para acessar os objetos de destino às vezes é necessário para a funcionalidade adequada do programa.
A tabela a seguir contém uma lista dos tipos de destino permitidos e uma descrição do formato da cadeia de caracteres de destino.
Tipo de destino | Membro do DirectoryContextType | Formato de nome de destino |
---|---|---|
Controlador de domínio | DirectoryServer | O nome DNS do controlador de domínio. |
Instância do AD LDS | 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. |
Floresta | Forest | O nome DNS da floresta, por exemplo, corp.fabrikam.com. |
Partição de Aplicativo | ApplicationPartition | O nome DNS da partição do aplicativo. |
Conjunto de configurações do AD LDS | ConfigurationSet | Uma das palavras-chave associadas ao ponto de conexão de serviço registrado pelas instâncias do AD LDS para o conjunto de configuração. |
Construtores
DirectoryContext(DirectoryContextType) |
Inicializa uma nova instância da classe DirectoryContext do tipo especificado que contém as credenciais do contexto do usuário atual. |
DirectoryContext(DirectoryContextType, String) |
Inicializa uma nova instância da classe DirectoryContext do tipo especificado que contém o nome especificado e as credenciais do contexto do usuário atual. |
DirectoryContext(DirectoryContextType, String, String) |
Inicializa uma nova instância da classe DirectoryContext do tipo especificado que contém o nome de usuário e senha especificados. |
DirectoryContext(DirectoryContextType, String, String, String) |
Inicializa uma nova instância da classe DirectoryContext do tipo especificado que contém o destino, nome de usuário e senha especificados. |
Propriedades
ContextType |
Obtém o tipo do objeto de contexto. |
Name |
Obtém o nome do contexto. |
UserName |
Obtém o nome de usuário do contexto. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |