DirectoryEntry DirectoryEntry DirectoryEntry DirectoryEntry Class

Definizione

La classe DirectoryEntry incapsula un nodo o un oggetto nella gerarchia dei 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

Utilizzare questa classe per l'associazione agli oggetti, o la lettura e aggiornamento degli attributi.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, con classi helper, fornisce supporto per il ciclo di vita i metodi di navigazione e gestione.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. Questi includono creazione, eliminazione, ridenominazione, spostamento di un nodo figlio e l'enumerazione di 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é possano salvare la struttura ad 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 utilizzabile per accedere a voci regolari e alcuni, ma non tutte, le informazioni da 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. Reti aziendali cambiano costantemente quando assunzione di nuovi dipendenti e gli oggetti, ad esempio computer e stampanti di rete vengono aggiunti.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Tecnologia Active Directory Service Interfaces (ADSI) offre la possibilità a livello di codice aggiungere questi oggetti all'albero 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, usare il Children proprietà.To create a directory entry in the hierarchy, use the Children property. Il Children proprietà è una raccolta che fornisce un Add metodo tramite cui si aggiunge un nodo alla raccolta direttamente sotto il nodo padre che si è attualmente associati.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, è possibile usare uno schema denominato "Computer" per aggiungere nuovi computer nella gerarchia di.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Questa classe contiene inoltre attributi la memorizzazione nella cache, 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 di attributo, vedere il UsePropertyCache proprietà.To use attribute caching, see the UsePropertyCache property.

Le classi associate di DirectoryEntry componente può essere utilizzato con uno qualsiasi dei provider di servizi di 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 dei provider corrente sono WinNT, Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) e Internet Information Services (IIS).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 di avere una conoscenza generale dei servizi di dominio Active Directory prima di usare questa classe.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Per altre informazioni, vedere il System.DirectoryServices panoramica dello spazio dei nomi.For more information, see the System.DirectoryServices namespace overview.

Costruttori

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

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

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

Inizializza una nuova istanza della classe DirectoryEntry che viene associata all'oggetto dei 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) DirectoryEntry(String) DirectoryEntry(String) 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) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String)

Inizializza una nuova istanza della 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)

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

Proprietà

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

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

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
Children Children Children 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 Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
Guid Guid Guid Guid

Ottiene l'GUID di DirectoryEntry.Gets the GUID of the DirectoryEntry.

Name Name Name 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 NativeGuid NativeGuid NativeGuid

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

NativeObject NativeObject NativeObject NativeObject

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

ObjectSecurity ObjectSecurity ObjectSecurity ObjectSecurity

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

Options Options Options Options

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

Parent Parent Parent Parent

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

Password Password Password Password

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

Path Path Path Path

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

Properties Properties Properties Properties

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

SchemaClassName SchemaClassName SchemaClassName SchemaClassName

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

SchemaEntry SchemaEntry SchemaEntry SchemaEntry

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

Site Site Site Site

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

(Inherited from Component)
UsePropertyCache UsePropertyCache UsePropertyCache UsePropertyCache

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

Username Username Username Username

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

Metodi

Close() Close() Close() 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() CommitChanges() CommitChanges() 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) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) 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) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) 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) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
DeleteTree() DeleteTree() DeleteTree() 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() Dispose() Dispose() Dispose()

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

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

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

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

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

(Inherited from Object)
Exists(String) Exists(String) Exists(String) 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() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

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

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

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

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

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

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

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

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

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

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

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

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

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

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

MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) 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() RefreshCache() RefreshCache() 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[]) RefreshCache(String[]) RefreshCache(String[]) 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) Rename(String) Rename(String) Rename(String)

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

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

(Inherited from Component)

Eventi

Disposed Disposed Disposed 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.

(Inherited from Component)

Sicurezza

DirectoryServicesPermission
LinkDemand

Si applica a