DirectoryEntry Classe

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacote:

System.DirectoryServices v8.0.0

Origem:

DirectoryEntry.cs

A classe DirectoryEntry encapsula um nó ou um 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 navegação e gerenciamento do 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 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 (Active Directory Service Interfaces) fornece maneiras de adicionar programaticamente esses objetos à árvore de diretórios.

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 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 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 de Active Directory Domain Services antes de usar essa classe. Para obter mais informações, consulte a visão geral do System.DirectoryServices namespace.

Construtores

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

Propriedades

AuthenticationType	Obtém ou define o tipo de autenticação a ser usado.
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Children	Obtém as entradas filhas deste nó na hierarquia do Active Directory Domain Services.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
Guid	Obtém o GUID do DirectoryEntry.
Name	Obtém o nome do objeto conforme nomeado com o serviço de diretório subjacente.
NativeGuid	Obtém o GUID da DirectoryEntry, conforme retornado pelo provedor.
NativeObject	Obtém o objeto nativo das ADSI (Active Directory Service Interfaces).
ObjectSecurity	Obtém ou define o descritor de segurança para esta entrada.
Options	Obtém as opções específicas do provedor para esta entrada.
Parent	Obtém o pai da entrada na hierarquia do Active Directory Domain Services.
Password	Define a senha a ser usada na autenticação do cliente.
Path	Obtém ou define o caminho deste DirectoryEntry.
Properties	Obtém as propriedades do Active Directory Domain Services para esse objeto DirectoryEntry.
SchemaClassName	Obtém o nome da classe de esquema deste objeto DirectoryEntry.
SchemaEntry	Obtém o objeto de esquema para essa entrada.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
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 que será usado para autenticar o cliente.

Métodos

Close()	Fecha o objeto DirectoryEntry e libera todos os recursos do sistema que estão 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)	Cria uma cópia desta entrada como um filho do pai especificado.
CopyTo(DirectoryEntry, String)	Cria uma cópia deste objeto DirectoryEntry, como um filho do objeto DirectoryEntry pai especificado, com o novo nome especificado.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
DeleteTree()	Exclui essa entrada e sua subárvore inteira da hierarquia do Active Directory Domain Services.
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Descarta os recursos (exceto a memória) usados pelo DirectoryEntry.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Exists(String)	Determina se o caminho especificado representa uma entrada real no serviço de diretório.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
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.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MoveTo(DirectoryEntry)	Move este objeto DirectoryEntry para o pai especificado.
MoveTo(DirectoryEntry, String)	Move este objeto DirectoryEntry para o pai especificado e altera seu nome para o valor especificado.
RefreshCache()	Carrega os valores da propriedade para esse objeto DirectoryEntry no cache de propriedades.
RefreshCache(String[])	Carrega os valores das propriedades especificadas no cache de propriedades.
Rename(String)	Altera o nome deste objeto DirectoryEntry.
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)