DirectoryEntry Classe

Definizione

La classe DirectoryEntry incapsula un nodo o un oggetto nella gerarchia di Servizi di dominio Active Directory.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
Ereditarietà
Attributi

Commenti

Usare questa classe per l'associazione a oggetti o per la lettura e l'aggiornamento degli attributi.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, insieme alle classi helper, fornisce il supporto per i metodi di navigazione e gestione del ciclo di vita.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. Sono incluse la creazione, l'eliminazione, la ridenominazione, lo trasferimento di un nodo figlio e l'enumerazione degli elementi figlio.These include creating, deleting, renaming, moving a child node, and enumerating children. Dopo aver modificato un nodo, è necessario eseguire il commit delle modifiche affinché vengano salvate nell'albero.After you modify a node, you must commit your changes in order for them to be saved to the tree. Per altre informazioni, vedere la proprietà CommitChanges.For more information, see the CommitChanges property.

DirectoryEntry possibile utilizzare per accedere alle voci regolari e ad alcune, ma non tutte, le informazioni dalle voci dello schema.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

La gerarchia di Active Directory Domain Services contiene fino a diverse migliaia di nodi.The Active Directory Domain Services hierarchy contains up to several thousand nodes. Ogni nodo rappresenta un oggetto, ad esempio una stampante di rete o un utente in un dominio.Each node represents an object, such as a network printer or a user in a domain. Le reti aziendali cambiano continuamente quando vengono assunti nuovi dipendenti e vengono aggiunti oggetti quali stampanti di rete e computer.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Active Directory tecnologia ADSI (Service Interfaces) fornisce modi per aggiungere questi oggetti alla struttura di directory.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

Per creare una voce di directory nella gerarchia, utilizzare la proprietà Children.To create a directory entry in the hierarchy, use the Children property. La proprietà Children è una raccolta che fornisce un metodo di Add, tramite il quale è possibile aggiungere un nodo alla raccolta direttamente al di sotto del nodo padre al quale si è attualmente connessi.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. Quando si aggiunge un nodo alla raccolta, è necessario specificare un nome per il nuovo nodo e il nome di un modello di schema che si desidera associare al nodo.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. Ad esempio, potrebbe essere necessario utilizzare uno schema denominato "computer" per aggiungere nuovi computer alla gerarchia.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Questa classe contiene anche la memorizzazione nella cache degli attributi, che può essere utile per ottimizzare il traffico di rete.This class also contains attribute caching, which can be useful for optimizing network traffic. Per usare la memorizzazione nella cache degli attributi, vedere la proprietà UsePropertyCache.To use attribute caching, see the UsePropertyCache property.

Le classi associate al componente DirectoryEntry possono essere utilizzate con qualsiasi provider di servizi Active Directory Domain Services.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. Alcuni provider correnti sono Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) e WinNT.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

Nota

Si presuppone che l'utente abbia una conoscenza generale di Active Directory Domain Services prima di utilizzare questa classe.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Per ulteriori informazioni, vedere la panoramica dello spazio dei nomi System.DirectoryServices.For more information, see the System.DirectoryServices namespace overview.

Costruttori

DirectoryEntry()

Inizializza una nuova istanza della classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object)

Inizializza una nuova istanza della classe DirectoryEntry che viene associata all'oggetto Servizi di dominio Active Directory nativo specificato.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String)

Inizializza una nuova istanza della classe DirectoryEntry che associa questa istanza al nodo dei Servizi di dominio Active Directory rilevato nel percorso specificato.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)

Inizializza una nuova istanza della classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes)

Inizializza una nuova istanza della classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

Proprietà

AuthenticationType

Recupera o imposta il tipo di autenticazione da usare.Gets or sets the type of authentication to use.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Children

Ottiene le voci figlio del nodo nella gerarchia dei Servizi di dominio Active Directory.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
Guid

Ottiene il GUID di DirectoryEntry.Gets the GUID of the DirectoryEntry.

Name

Recupera il nome dell'oggetto specificato nel sottostante sistema di directory.Gets the name of the object as named with the underlying directory service.

NativeGuid

Ottiene il GUID dell'oggetto DirectoryEntry, come restituito dal provider.Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject

Recupera l'oggetto ADSI (Active Directory Service Interface) nativo.Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity

Ottiene o imposta il descrittore di sicurezza per questa voce.Gets or sets the security descriptor for this entry.

Options

Ottiene le opzioni specifiche del provider per questa voce.Gets the provider-specific options for this entry.

Parent

Ottiene l'elemento padre di questa voce nella gerarchia di Servizi di dominio Active Directory.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password

Imposta la password da usare durante l'autenticazione del client.Sets the password to use when authenticating the client.

Path

Recupera o imposta il percorso per DirectoryEntry.Gets or sets the path for this DirectoryEntry.

Properties

Ottiene le proprietà di Servizi di dominio Active Directory per questo oggetto DirectoryEntry.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName

Ottiene il nome della classe di schema per questo oggetto DirectoryEntry.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry

Ottiene l'oggetto schema per questa voce.Gets the schema object for this entry.

Site

Ottiene o imposta l'oggetto ISite dell'oggetto Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
UsePropertyCache

Recupera o imposta un valore che indica se deve essere eseguito il commit della cache dopo ogni operazione.Gets or sets a value indicating whether the cache should be committed after each operation.

Username

Recupera o imposta il nome utente da usare quando si autentica il client.Gets or sets the user name to use when authenticating the client.

Metodi

Close()

Chiude l'oggetto DirectoryEntry e rende disponibili le risorse di sistema associate al componente.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges()

Salva le modifiche apportate a una voce di directory nell'archivio directory sottostante.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry)

Crea una copia della voce come membro figlio dell'elemento padre specificato.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String)

Crea una copia di questo oggetto DirectoryEntry come elemento figlio dell'oggetto DirectoryEntry padre specificato, con il nuovo nome fornito.Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
DeleteTree()

Elimina questa voce e tutto il relativo sottoalbero dalla gerarchia dei Servizi di dominio Active Directory.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Elimina le risorse, diverse dalla memoria, usate dall'oggetto DirectoryEntry.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Exists(String)

Determina se il percorso specificato rappresenta una voce effettiva nel servizio di directory.Determines if the specified path represents an actual entry in the directory service.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
Invoke(String, Object[])

Chiama un metodo sull'oggetto Servizi di dominio Active Directory nativo.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String)

Ottiene una proprietà dall'oggetto Servizi di dominio Active Directory nativo.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[])

Imposta una proprietà sull'oggetto Servizi di dominio Active Directory nativo.Sets a property on the native Active Directory Domain Services object.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
MoveTo(DirectoryEntry)

Sposta questo oggetto DirectoryEntry nell'elemento padre specificato.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String)

Sposta questo oggetto DirectoryEntry nell'elemento padre specificato e ne imposta il nome sul valore fornito.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache()

Carica i valori delle proprietà di questo oggetto DirectoryEntry nella cache delle proprietà.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[])

Carica i valori delle proprietà specificate nella cache delle proprietà.Loads the values of the specified properties into the property cache.

Rename(String)

Cambia il nome di questo oggetto DirectoryEntry.Changes the name of this DirectoryEntry object.

ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Ereditato da Component)

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)

Sicurezza

DirectoryServicesPermission
LinkDemand

Si applica a