DirectoryEntry Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
La classe DirectoryEntry incapsula un nodo o un oggetto nella gerarchia di Servizi di dominio Active Directory.
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- Ereditarietà
- Attributi
Commenti
Utilizzare questa classe per l'associazione a oggetti o la lettura e l'aggiornamento degli attributi. DirectoryEntry, insieme alle classi helper, fornisce supporto per i metodi di gestione e navigazione del ciclo di vita. Questi includono la creazione, l'eliminazione, la ridenominazione, lo spostamento di un nodo figlio e l'enumerazione degli elementi figlio. Dopo aver modificato un nodo, è necessario eseguire il commit delle modifiche affinché vengano salvate nell'albero. Per altre informazioni, vedere la proprietà CommitChanges.
DirectoryEntry può essere usato per accedere a voci regolari e ad alcune informazioni, ma non tutte, dalle voci dello schema.
La gerarchia Active Directory Domain Services contiene fino a diverse migliaia di nodi. Ogni nodo rappresenta un oggetto, ad esempio una stampante di rete o un utente in un dominio. Le reti aziendali cambiano costantemente man mano che vengono assunti nuovi dipendenti e vengono aggiunti oggetti come stampanti di rete e computer. La tecnologia ADSI (Active Directory Service Interfaces) consente di aggiungere questi oggetti a livello di codice all'albero delle directory.
Per creare una voce di directory nella gerarchia, utilizzare la Children proprietà . La Children proprietà è una raccolta che fornisce un Add metodo, tramite il quale si aggiunge un nodo alla raccolta direttamente sotto il nodo padre a cui si è attualmente associati. Quando si aggiunge un nodo alla raccolta, è necessario specificare un nome per il nuovo nodo e il nome di un modello di schema da associare al nodo. Ad esempio, è possibile usare uno schema denominato "Computer" per aggiungere nuovi computer alla gerarchia.
Questa classe contiene anche la memorizzazione nella cache degli attributi, che può essere utile per ottimizzare il traffico di rete. Per usare la memorizzazione nella cache degli attributi, vedere la UsePropertyCache proprietà .
Le classi associate al DirectoryEntry componente possono essere usate con uno dei provider di servizi Active Directory Domain Services. Alcuni dei provider correnti sono Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) e WinNT.
Nota
Si presuppone che si abbia una conoscenza generale di Active Directory Domain Services prima di usare questa classe. Per altre informazioni, vedere panoramica dello System.DirectoryServices spazio dei nomi.
Costruttori
| DirectoryEntry() |
Inizializza una nuova istanza della classe DirectoryEntry. |
| DirectoryEntry(Object) |
Inizializza una nuova istanza della classe DirectoryEntry che viene associata all'oggetto Servizi di dominio Active Directory nativo specificato. |
| 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. |
| DirectoryEntry(String, String, String) |
Inizializza una nuova istanza della classe DirectoryEntry. |
| DirectoryEntry(String, String, String, AuthenticationTypes) |
Inizializza una nuova istanza della classe DirectoryEntry. |
Proprietà
| AuthenticationType |
Recupera o imposta il tipo di autenticazione da usare. |
| CanRaiseEvents |
Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component) |
| Children |
Ottiene le voci figlio del nodo nella gerarchia dei Servizi di dominio Active Directory. |
| Container |
Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component) |
| DesignMode |
Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component) |
| Events |
Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component) |
| Guid |
Ottiene il GUID dell'oggetto DirectoryEntry. |
| Name |
Recupera il nome dell'oggetto specificato nel sottostante sistema di directory. |
| NativeGuid |
Ottiene il GUID dell'oggetto DirectoryEntry, come restituito dal provider. |
| NativeObject |
Recupera l'oggetto ADSI (Active Directory Service Interface) nativo. |
| ObjectSecurity |
Ottiene o imposta il descrittore di sicurezza per questa voce. |
| Options |
Ottiene le opzioni specifiche del provider per questa voce. |
| Parent |
Ottiene l'elemento padre di questa voce nella gerarchia di Servizi di dominio Active Directory. |
| Password |
Imposta la password da usare durante l'autenticazione del client. |
| Path |
Recupera o imposta il percorso per DirectoryEntry. |
| Properties |
Ottiene le proprietà di Servizi di dominio Active Directory per questo oggetto DirectoryEntry. |
| SchemaClassName |
Ottiene il nome della classe di schema per questo oggetto DirectoryEntry. |
| SchemaEntry |
Ottiene l'oggetto schema per questa voce. |
| Site |
Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component) |
| UsePropertyCache |
Recupera o imposta un valore che indica se deve essere eseguito il commit della cache dopo ogni operazione. |
| Username |
Recupera o imposta il nome utente da usare quando si autentica il client. |
Metodi
| Close() |
Chiude l'oggetto DirectoryEntry e rende disponibili le risorse di sistema associate al componente. |
| CommitChanges() |
Salva le modifiche apportate a una voce di directory nell'archivio directory sottostante. |
| CopyTo(DirectoryEntry) |
Crea una copia della voce come membro figlio dell'elemento padre specificato. |
| CopyTo(DirectoryEntry, String) |
Crea una copia di questo oggetto DirectoryEntry come elemento figlio dell'oggetto DirectoryEntry padre specificato, con il nuovo nome fornito. |
| 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. (Ereditato da MarshalByRefObject) |
| DeleteTree() |
Elimina questa voce e tutto il relativo sottoalbero dalla gerarchia dei Servizi di dominio Active Directory. |
| Dispose() |
Rilascia tutte le risorse usate da Component. (Ereditato da Component) |
| Dispose(Boolean) |
Elimina le risorse, diverse dalla memoria, usate dall'oggetto DirectoryEntry. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Exists(String) |
Determina se il percorso specificato rappresenta una voce effettiva nel servizio di directory. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
| GetService(Type) |
Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| Invoke(String, Object[]) |
Chiama un metodo sull'oggetto Servizi di dominio Active Directory nativo. |
| InvokeGet(String) |
Ottiene una proprietà dall'oggetto Servizi di dominio Active Directory nativo. |
| InvokeSet(String, Object[]) |
Imposta una proprietà sull'oggetto Servizi di dominio Active Directory nativo. |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
| MoveTo(DirectoryEntry) |
Sposta questo oggetto DirectoryEntry nell'elemento padre specificato. |
| MoveTo(DirectoryEntry, String) |
Sposta questo oggetto DirectoryEntry nell'elemento padre specificato e ne imposta il nome sul valore fornito. |
| RefreshCache() |
Carica i valori delle proprietà di questo oggetto DirectoryEntry nella cache delle proprietà. |
| RefreshCache(String[]) |
Carica i valori delle proprietà specificate nella cache delle proprietà. |
| Rename(String) |
Cambia il nome di questo oggetto DirectoryEntry. |
| ToString() |
Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component) |
Eventi
| Disposed |
Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component) |
