DirectoryContext Classe

Definição

A classe DirectoryContext identifica um diretório específico e as credenciais usadas para acessar o diretório.The DirectoryContext class identifies a specific directory and the credentials that are used to access the directory.

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 uma floresta.A directory context must be created before accessing the methods and properties of a System.DirectoryServices.ActiveDirectory directory object such as a domain or forest.

Ao criar um contexto de diretório, as credenciais atuais do processo ou as credenciais alternativas podem ser aplicadas a esse contexto usando o construtor apropriado.When creating a directory context, the process' current credentials or alternate credentials can be applied to that context by using the appropriate constructor. Essas credenciais determinam as permissões que estão em vigor quando o programa acessa objetos de diretório.These credentials determine the permissions that are in effect when the program accesses directory objects. Como os objetos de Active Directory Domain Services 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 de programa adequada.Because Active Directory Domain Services objects might be protected against retrieval or modification by non-administrative users, the use of alternate credentials with permission to access the target objects is sometimes necessary for proper program functionality.

A tabela a seguir contém uma lista dos tipos de destino que são permitidos e uma descrição do formato da cadeia de caracteres de destino.The following table contains a list of the target types that are allowed and a description of the format of the target string.

Tipo de destinoTarget type Membro do DirectoryContextTypeDirectoryContextType member Formato do nome de destinoTarget name format
Controlador de domínioDomain Controller DirectoryServer O nome DNS do controlador de domínio.The DNS name of the domain controller.
Instância de AD LDSAD LDS Instance DirectoryServer O nome DNS do servidor de AD LDS e o número da porta LDAP, por exemplo, ad_lds_instance. fabrikam. com: 389.The DNS name of the AD LDS server and the LDAP port number, for example, ad_lds_instance.fabrikam.com:389.
DomínioDomain Domain O nome DNS do domínio, por exemplo, sales.corp.fabrikam.com.The DNS name of the domain, for example, sales.corp.fabrikam.com.
FlorestaForest Forest O nome DNS da floresta, por exemplo, corp.fabrikam.com.The DNS name of the forest, for example, corp.fabrikam.com.
Partição de aplicativoApplication Partition ApplicationPartition O nome DNS da partição de aplicativo.The DNS name of the application partition.
Conjunto de configuração de AD LDSAD LDS Configuration Set ConfigurationSet Uma das palavras-chave que está associada ao ponto de conexão de serviço registrado por AD LDS instâncias para o conjunto de configuração.One of the keywords that is associated with the service connection point registered by AD LDS instances for the configuration set.

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.Initializes a new instance of the DirectoryContext class of the specified type that contains the credentials of the current user context.

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.Initializes a new instance of the DirectoryContext class of the specified type that contains the specified name and the credentials of the current user context.

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.Initializes a new instance of the DirectoryContext class of the specified type that contains the specified user name and password.

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.Initializes a new instance of the DirectoryContext class of the specified type that contains the specified target, user name, and password.

Propriedades

ContextType

Obtém o tipo do objeto de contexto.Gets the type of the context object.

Name

Obtém o nome do contexto.Gets the name of the context.

UserName

Obtém o nome de usuário do contexto.Gets the user name of the context.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a