DirectoryEntry Classe

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Origem:

DirectoryEntry.cs

A DirectoryEntry classe encapsula um nó ou objeto na hierarquia do Active Directory Domain Services.

public ref class DirectoryEntry : System::ComponentModel::Component

[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component

[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component

Public Class DirectoryEntry
Inherits Component

Herança

Object

MarshalByRefObject

Component

DirectoryEntry

Atributos

TypeConverterAttribute

Comentários

Use essa classe para associar a objetos ou ler e atualizar atributos. DirectoryEntry, juntamente com classes auxiliares, fornece suporte para métodos de gerenciamento e navegação de ciclo de vida. Isso inclui criar, excluir, renomear, mover um nó filho e enumerar filhos. Depois de modificar um nó, você deve confirmar suas alterações para que elas sejam salvas na árvore. Para obter mais informações, consulte a propriedade CommitChanges().

DirectoryEntry pode ser usado para acessar entradas regulares e algumas, mas não todas, informações de entradas de esquema.

A hierarquia do Active Directory Domain Services contém até milhares de nós. Cada nó representa um objeto, como uma impressora de rede ou um usuário em um domínio. As redes corporativas mudam constantemente à medida que novos funcionários são contratados e objetos como impressoras de rede e computadores são adicionados. A tecnologia ADSI (Interfaces de Serviço) do Active Directory fornece maneiras de adicionar esses objetos programaticamente à árvore de diretório.

Para criar uma entrada de diretório na hierarquia, use a Children propriedade. A Children propriedade é uma coleção que fornece um Add método, por meio do qual você adiciona um nó à coleção diretamente abaixo do nó pai ao qual você está associado no momento. Ao adicionar um nó à coleção, você deve especificar um nome para o novo nó e o nome de um modelo de esquema que você deseja associar ao nó. Por exemplo, talvez você queira usar um esquema intitulado "Computador" para adicionar novos computadores à hierarquia.

Essa classe também contém o cache de atributos, que pode ser útil para otimizar o tráfego de rede. Para usar o cache de atributo, consulte a UsePropertyCache propriedade.

As classes associadas ao DirectoryEntry componente podem ser usadas com qualquer um dos provedores de serviços do Active Directory Domain Services. Alguns dos provedores atuais são IIS (Serviços de Informações da Internet), LDAP (Lightweight Directory Access Protocol), NDS (Novell NetWare Directory Service) e WinNT.

Observação

Supõe-se que você tenha uma compreensão geral dos Serviços de Domínio do Active Directory antes de usar essa classe. Para obter mais informações, consulte a visão geral do System.DirectoryServices namespace.

Construtores

Nome	Description
DirectoryEntry()	Inicializa uma nova instância da classe DirectoryEntry.
DirectoryEntry(Object)	Inicializa uma nova instância da DirectoryEntry classe que se associa ao objeto nativo do Active Directory Domain Services especificado.
DirectoryEntry(String, String, String, AuthenticationTypes)	Inicializa uma nova instância da classe DirectoryEntry.
DirectoryEntry(String, String, String)	Inicializa uma nova instância da classe DirectoryEntry.
DirectoryEntry(String)	Inicializa uma nova instância da DirectoryEntry classe que associa essa instância ao nó no Active Directory Domain Services localizado no caminho especificado.

Propriedades

Nome	Description
AuthenticationType	Obtém ou define o tipo de autenticação a ser usado.
Children	Obtém as entradas filho desse nó na hierarquia do Active Directory Domain Services.
Guid	Obtém o GUID do DirectoryEntry.
Name	Obtém o nome do objeto como nomeado com o serviço de diretório subjacente.
NativeGuid	Obtém o GUID do DirectoryEntry, conforme retornado do provedor.
NativeObject	Obtém o objeto ADSI (Interfaces de Serviço do Active Directory) nativo.
ObjectSecurity	Obtém ou define o descritor de segurança para esta entrada.
Options	Obtém as opções específicas do provedor para essa entrada.
Parent	Obtém o pai dessa entrada na hierarquia do Active Directory Domain Services.
Password	Define a senha a ser usada ao autenticar o cliente.
Path	Obtém ou define o caminho para isso DirectoryEntry.
Properties	Obtém as propriedades do Active Directory Domain Services para este DirectoryEntry objeto.
SchemaClassName	Obtém o nome da classe de esquema para este DirectoryEntry objeto.
SchemaEntry	Obtém o objeto de esquema dessa entrada.
UsePropertyCache	Obtém ou define um valor que indica se o cache deve ser confirmado após cada operação.
Username	Obtém ou define o nome de usuário a ser usado ao autenticar o cliente.

Métodos

Nome	Description
Close()	Fecha o DirectoryEntry objeto e libera todos os recursos do sistema associados a esse componente.
CommitChanges()	Salva as alterações feitas em uma entrada de diretório no repositório de diretórios subjacente.
CopyTo(DirectoryEntry, String)	Cria uma cópia desse DirectoryEntry objeto, como um filho do objeto pai DirectoryEntry especificado, com o novo nome especificado.
CopyTo(DirectoryEntry)	Cria uma cópia dessa entrada como um filho do pai especificado.
DeleteTree()	Exclui essa entrada e toda a subárvore da hierarquia do Active Directory Domain Services.
Dispose(Boolean)	Descarta os recursos (além da memória) que são usados pelo DirectoryEntry.
Exists(String)	Determina se o caminho especificado representa uma entrada real no serviço de diretório.
Invoke(String, Object[])	Chama um método no objeto nativo do Active Directory Domain Services.
InvokeGet(String)	Obtém uma propriedade do objeto nativo do Active Directory Domain Services.
InvokeSet(String, Object[])	Define uma propriedade no objeto nativo do Active Directory Domain Services.
MoveTo(DirectoryEntry, String)	Move esse DirectoryEntry objeto para o pai especificado e altera seu nome para o valor especificado.
MoveTo(DirectoryEntry)	Move esse DirectoryEntry objeto para o pai especificado.
RefreshCache()	Carrega os valores de propriedade desse DirectoryEntry objeto no cache de propriedades.
RefreshCache(String[])	Carrega os valores das propriedades especificadas no cache de propriedades.
Rename(String)	Altera o nome desse DirectoryEntry objeto.