DirectoryEntry Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
A classe DirectoryEntry encapsula um nó ou objeto na hierarquia 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))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.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
Observações
Use esta classe para atribuir a objetos, ou para ler e atualizar atributos. DirectoryEntry, juntamente com as classes auxiliares, fornece suporte para a gestão do ciclo de vida e métodos de navegação. Estas incluem criar, eliminar, renomear, mover um nó filho e enumerar filhos. Depois de modificares um nó, tens de comprometer as tuas alterações para que possam ser guardadas na árvore. Para obter mais informações, consulte a propriedade CommitChanges().
DirectoryEntry pode ser usado para aceder a entradas regulares e a alguma, mas não a toda, a informação das entradas do esquema.
A hierarquia Active Directory Domain Services contém até vários milhares de nós. Cada nó representa um objeto, como uma impressora de rede ou um utilizador num domínio. As redes corporativas mudam constantemente à medida que novos colaboradores são contratados e objetos como impressoras de rede e computadores são adicionados. A tecnologia Active Directory Service Interfaces (ADSI) fornece formas de adicionar programaticamente estes 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, através do qual adiciona um nó à coleção diretamente abaixo do nó pai ao qual está atualmente vinculado. Ao adicionar um nó à coleção, deve especificar um nome para o novo nó e o nome de um modelo de esquema que pretende associar ao nó. Por exemplo, pode querer usar um esquema intitulado "Computador" para adicionar novos computadores à hierarquia.
Esta classe também contém cache de atributos, que pode ser útil para otimizar o tráfego de rede. Para usar cache de atributos, consulte a UsePropertyCache propriedade.
As classes associadas ao componente DirectoryEntry podem ser usadas com qualquer um dos fornecedores de serviços Active Directory Domain Services. Alguns dos fornecedores atuais são Serviços de Informação Internet (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) e WinNT.
Note
Presume-se que tens uma compreensão geral do Active Directory Domain Services antes de usar esta classe. Para mais informações, consulte a visão geral do System.DirectoryServices espaço de nomes.
Construtores
| Name | Description |
|---|---|
| DirectoryEntry() |
Inicializa uma nova instância da DirectoryEntry classe. |
| DirectoryEntry(Object) |
Inicializa uma nova instância da classe DirectoryEntry que se liga ao objeto nativo de Active Directory Domain Services especificado. |
| DirectoryEntry(String, String, String, AuthenticationTypes) |
Inicializa uma nova instância da DirectoryEntry classe. |
| DirectoryEntry(String, String, String) |
Inicializa uma nova instância da DirectoryEntry classe. |
| DirectoryEntry(String) |
Inicializa uma nova instância da classe DirectoryEntry que liga esta instância ao nó em Active Directory Domain Services localizado no caminho especificado. |
Propriedades
| Name | Description |
|---|---|
| AuthenticationType |
Obtém ou definem o tipo de autenticação a usar. |
| CanRaiseEvents |
Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component) |
| Children |
Obtém as entradas filhas deste nó na hierarquia 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á atualmente em modo de design. (Herdado de Component) |
| Events |
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| 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 |
Recebe o GUID do DirectoryEntry, conforme devolvido pelo fornecedor. |
| NativeObject |
Obtém o objeto nativo Active Directory Service Interfaces (ADSI). |
| ObjectSecurity |
Recebe ou define o descritor de segurança para esta entrada. |
| Options |
Recebe as opções específicas do fornecedor para esta entrada. |
| Parent |
Obtém o pai desta entrada na hierarquia Active Directory Domain Services. |
| Password |
Define a palavra-passe para usar ao autenticar o cliente. |
| Path |
Obtém ou define o caminho para isto DirectoryEntry. |
| Properties |
Obtém as propriedades Active Directory Domain Services deste objeto DirectoryEntry. |
| SchemaClassName |
Obtém o nome da classe de esquema para este DirectoryEntry objeto. |
| SchemaEntry |
Obtém o objeto schema para esta entrada. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| UsePropertyCache |
Recebe ou define um valor que indica se a cache deve ser comprometida após cada operação. |
| Username |
Obtém ou define o nome de utilizador a usar ao autenticar o cliente. |
Métodos
| Name | Description |
|---|---|
| Close() |
Fecha o DirectoryEntry objeto e liberta quaisquer recursos do sistema associados a este componente. |
| CommitChanges() |
Guarda as alterações feitas a uma entrada de diretório para o armazenamento subjacente. |
| CopyTo(DirectoryEntry, String) |
Cria uma cópia deste DirectoryEntry objeto, como filho do objeto pai DirectoryEntry especificado, com o novo nome especificado. |
| CopyTo(DirectoryEntry) |
Cria uma cópia desta entrada como filho do pai especificado. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| DeleteTree() |
Elimina esta entrada e toda a sua subárvore da hierarquia Active Directory Domain Services. |
| Dispose() |
Liberta todos os recursos utilizados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Elimina os recursos (exceto a memória) que são 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 função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Devolve 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-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| Invoke(String, Object[]) |
Chama um método no objeto nativo Active Directory Domain Services. |
| InvokeGet(String) |
Obtém uma propriedade do objeto nativo Active Directory Domain Services. |
| InvokeSet(String, Object[]) |
Define uma propriedade no objeto nativo Active Directory Domain Services. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| MoveTo(DirectoryEntry, String) |
Move este DirectoryEntry objeto para o pai especificado e altera o seu nome para o valor especificado. |
| MoveTo(DirectoryEntry) |
Move este DirectoryEntry objeto para o pai especificado. |
| RefreshCache() |
Carrega os valores das propriedades deste DirectoryEntry objeto na cache de propriedades. |
| RefreshCache(String[]) |
Carrega os valores das propriedades especificadas na cache de propriedades. |
| Rename(String) |
Muda o nome deste DirectoryEntry objeto. |
| ToString() |
Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component) |
evento
| Name | Description |
|---|---|
| Disposed |
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |