DirectoryEntry Classe

Definizione

Spazio dei nomi:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacchetto:

System.DirectoryServices v8.0.0

Origine:

DirectoryEntry.cs

La classe DirectoryEntry incapsula un nodo o un oggetto nella gerarchia di Servizi di dominio Active Directory.

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))>]
type DirectoryEntry = class
    inherit Component

Public Class DirectoryEntry
Inherits Component

Ereditarietà

Object

MarshalByRefObject

Component

DirectoryEntry

Attributi

TypeConverterAttribute

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