DirectoryEntry Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
A classe DirectoryEntry encapsula um nó ou um objeto na hierarquia do Active Directory Domain Services.
public ref class DirectoryEntry : System::ComponentModel::Componentpublic 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.Componenttype 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 ComponentPublic 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) |
