DirectoryContext Classe

Definição

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)

Aplica-se a