DirectoryEntry DirectoryEntry DirectoryEntry DirectoryEntry Class

Definição

A classe DirectoryEntry encapsula um nó ou um objeto na hierarquia do Active Directory Domain Services.The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

public ref class DirectoryEntry : System::ComponentModel::Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
Herança
Atributos

Comentários

Use essa classe para associação a objetos ou leitura e atualização de atributos.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, juntamente com as classes auxiliares, fornece suporte para os métodos de navegação e gerenciamento do ciclo de vida.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. Isso inclui criar, excluir, renomear, mover um nó filho e enumerar filhos.These include creating, deleting, renaming, moving a child node, and enumerating children. Depois de modificar um nó, você deve confirmar suas alterações para que elas sejam salvas na árvore.After you modify a node, you must commit your changes in order for them to be saved to the tree. Para obter mais informações, consulte a propriedade CommitChanges.For more information, see the CommitChanges property.

DirectoryEntrypode ser usado para acessar entradas regulares e algumas, mas não todas, informações de entradas de esquema.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

A hierarquia de Active Directory Domain Services contém até vários milhares de nós.The Active Directory Domain Services hierarchy contains up to several thousand nodes. Cada nó representa um objeto, como uma impressora de rede ou um usuário em um domínio.Each node represents an object, such as a network printer or a user in a domain. As redes corporativas mudam constantemente conforme novos funcionários são contratados e objetos como impressoras de rede e computadores são adicionados.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. A tecnologia ADSI (Active Directory Service Interfaces) fornece maneiras de adicionar esses objetos programaticamente à árvore de diretórios.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

Para criar uma entrada de diretório na hierarquia, use a Children propriedade.To create a directory entry in the hierarchy, use the Children property. 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á vinculado no momento.The Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. 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ó.When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. Por exemplo, talvez você queira usar um esquema intitulado "computador" para adicionar novos computadores à hierarquia.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Essa classe também contém o cache de atributos, que pode ser útil para otimizar o tráfego de rede.This class also contains attribute caching, which can be useful for optimizing network traffic. Para usar o cache de atributos, UsePropertyCache consulte a propriedade.To use attribute caching, see the UsePropertyCache property.

As classes associadas DirectoryEntry ao componente podem ser usadas com qualquer um dos provedores de serviço Active Directory Domain Services.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. Alguns dos provedores atuais são Serviços de Informações da Internet (IIS), LDAP (Lightweight Directory Access Protocol), NDS (Novell NetWare Directory Service) e WinNT.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

Observação

Supõe-se que você tenha uma compreensão geral de Active Directory Domain Services antes de usar essa classe.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Para obter mais informações, consulte System.DirectoryServices a visão geral do namespace.For more information, see the System.DirectoryServices namespace overview.

Construtores

DirectoryEntry() DirectoryEntry() DirectoryEntry() DirectoryEntry()

Inicializa uma nova instância da classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object)

Inicializa uma nova instância da classe DirectoryEntry que é associada ao objeto especificado nativo do Active Directory Domain Services.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String) DirectoryEntry(String) DirectoryEntry(String) 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.Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String)

Inicializa uma nova instância da classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes)

Inicializa uma nova instância da classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

Propriedades

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

Obtém ou define o tipo de autenticação a ser usado.Gets or sets the type of authentication to use.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Children Children Children Children

Obtém as entradas filhas deste nó na hierarquia do Active Directory Domain Services.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Guid Guid Guid Guid

Obtém o GUID do DirectoryEntry.Gets the GUID of the DirectoryEntry.

Name Name Name Name

Obtém o nome do objeto conforme nomeado com o serviço de diretório subjacente.Gets the name of the object as named with the underlying directory service.

NativeGuid NativeGuid NativeGuid NativeGuid

Obtém o GUID da DirectoryEntry, conforme retornado pelo provedor.Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject NativeObject NativeObject NativeObject

Obtém o objeto nativo das ADSI (Active Directory Service Interfaces).Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity ObjectSecurity ObjectSecurity ObjectSecurity

Obtém ou define o descritor de segurança para esta entrada.Gets or sets the security descriptor for this entry.

Options Options Options Options

Obtém as opções específicas do provedor para esta entrada.Gets the provider-specific options for this entry.

Parent Parent Parent Parent

Obtém o pai da entrada na hierarquia do Active Directory Domain Services.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password Password Password Password

Define a senha a ser usada na autenticação do cliente.Sets the password to use when authenticating the client.

Path Path Path Path

Obtém ou define o caminho deste DirectoryEntry.Gets or sets the path for this DirectoryEntry.

Properties Properties Properties Properties

Obtém as propriedades do Active Directory Domain Services para esse objeto DirectoryEntry.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName SchemaClassName SchemaClassName SchemaClassName

Obtém o nome da classe de esquema deste objeto DirectoryEntry.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry SchemaEntry SchemaEntry SchemaEntry

Obtém o objeto de esquema para essa entrada.Gets the schema object for this entry.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
UsePropertyCache UsePropertyCache UsePropertyCache UsePropertyCache

Obtém ou define um valor que indica se o cache deve ser confirmado após cada operação.Gets or sets a value indicating whether the cache should be committed after each operation.

Username Username Username Username

Obtém ou define o nome de usuário que será usado para autenticar o cliente.Gets or sets the user name to use when authenticating the client.

Métodos

Close() Close() Close() Close()

Fecha o objeto DirectoryEntry e libera todos os recursos do sistema que estão associados a esse componente.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges() CommitChanges() CommitChanges() CommitChanges()

Salva as alterações feitas em uma entrada de diretório no repositório de diretórios subjacente.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry)

Cria uma cópia desta entrada como um filho do pai especificado.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String)

Cria uma cópia deste objeto DirectoryEntry, como um filho do objeto DirectoryEntry pai especificado, com o novo nome especificado.Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DeleteTree() DeleteTree() DeleteTree() DeleteTree()

Exclui essa entrada e sua subárvore inteira da hierarquia do Active Directory Domain Services.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Descarta os recursos (exceto a memória) usados pelo DirectoryEntry.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Exists(String) Exists(String) Exists(String) Exists(String)

Determina se o caminho especificado representa uma entrada real no serviço de diretório.Determines if the specified path represents an actual entry in the directory service.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[])

Chama um método no objeto nativo do Active Directory Domain Services.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String) InvokeGet(String) InvokeGet(String) InvokeGet(String)

Obtém uma propriedade do objeto nativo do Active Directory Domain Services.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[])

Define uma propriedade no objeto nativo do Active Directory Domain Services.Sets a property on the native Active Directory Domain Services object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry)

Move este objeto DirectoryEntry para o pai especificado.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String)

Move este objeto DirectoryEntry para o pai especificado e altera seu nome para o valor especificado.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache() RefreshCache() RefreshCache() RefreshCache()

Carrega os valores da propriedade para esse objeto DirectoryEntry no cache de propriedades.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[])

Carrega os valores das propriedades especificadas no cache de propriedades.Loads the values of the specified properties into the property cache.

Rename(String) Rename(String) Rename(String) Rename(String)

Altera o nome deste objeto DirectoryEntry.Changes the name of this DirectoryEntry object.

ToString() ToString() ToString() ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Inherited from Component)

Eventos

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Segurança

DirectoryServicesPermission
LinkDemand

Aplica-se a