Partilhar via


DirectoryEntry Classe

Definição

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

public ref class DirectoryEntry : System::ComponentModel::Component
public class DirectoryEntry : System.ComponentModel.Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public 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))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
[<System.DirectoryServices.DSDescription("DirectoryEntryDesc")>]
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
Herança
Atributos

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()
Obsoleto.

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()
Obsoleto.

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)

Aplica-se a