DirectoryEntry Classe

Definizione

Spazio dei nomi:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Origine:

DirectoryEntry.cs

La DirectoryEntry classe 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 ulteriori informazioni, consultare la proprietà CommitChanges().

DirectoryEntry può essere usato per accedere a voci regolari e ad alcune, ma non tutte, alle informazioni provenienti dalle voci dello schema.

La gerarchia di Servizi di dominio Active Directory 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 ACTIVE Directory Service Interfaces (ADSI) 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 qualsiasi dei provider di servizi di dominio Active Directory. Alcuni dei provider correnti sono Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) e WinNT.

Annotazioni

Si presuppone che si abbia una conoscenza generale di Active Directory Domain Services prima di usare questa classe. Per altre informazioni, vedere la panoramica dello System.DirectoryServices spazio dei nomi.

Costruttori

Nome	Descrizione
DirectoryEntry()	Inizializza una nuova istanza della classe DirectoryEntry.
DirectoryEntry(Object)	Inizializza una nuova istanza della DirectoryEntry classe che esegue l'associazione all'oggetto Active Directory Domain Services nativo specificato.
DirectoryEntry(String, String, String, AuthenticationTypes)	Inizializza una nuova istanza della classe DirectoryEntry.
DirectoryEntry(String, String, String)	Inizializza una nuova istanza della classe DirectoryEntry.
DirectoryEntry(String)	Inizializza una nuova istanza della DirectoryEntry classe che associa questa istanza al nodo in Servizi di dominio Active Directory che si trova nel percorso specificato.

Proprietà

Nome	Descrizione
AuthenticationType	Ottiene o imposta il tipo di autenticazione da utilizzare.
Children	Ottiene le voci figlio di questo nodo nella gerarchia di Servizi di dominio Active Directory.
Guid	Ottiene il GUID dell'oggetto DirectoryEntry.
Name	Ottiene il nome dell'oggetto come denominato con il servizio directory sottostante.
NativeGuid	Ottiene il GUID dell'oggetto DirectoryEntry, come restituito dal provider.
NativeObject	Ottiene l'oggetto ADSI (Active Directory Service Interfaces) 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 utilizzare per l'autenticazione del client.
Path	Ottiene o imposta il percorso per l'oggetto DirectoryEntry.
Properties	Ottiene le proprietà di Servizi di dominio Active Directory per questo DirectoryEntry oggetto.
SchemaClassName	Ottiene il nome della classe dello schema per questo DirectoryEntry oggetto.
SchemaEntry	Ottiene l'oggetto schema per questa voce.
UsePropertyCache	Ottiene o imposta un valore che indica se è necessario eseguire il commit della cache dopo ogni operazione.
Username	Ottiene o imposta il nome utente da utilizzare per l'autenticazione del client.

Metodi

Nome	Descrizione
Close()	Chiude l'oggetto DirectoryEntry e rilascia tutte le risorse di sistema associate a questo componente.
CommitChanges()	Salva le modifiche apportate a una voce di directory nell'archivio directory sottostante.
CopyTo(DirectoryEntry, String)	Crea una copia di questo DirectoryEntry oggetto, come elemento figlio dell'oggetto padre DirectoryEntry specificato, con il nuovo nome specificato.
CopyTo(DirectoryEntry)	Crea una copia di questa voce come figlio dell'elemento padre specificato.
DeleteTree()	Elimina questa voce e l'intero sottoalbero dalla gerarchia di Servizi di dominio Active Directory.
Dispose(Boolean)	Elimina le risorse (diverse dalla memoria) usate dall'oggetto DirectoryEntry.
Exists(String)	Determina se il percorso specificato rappresenta una voce effettiva nel servizio directory.
Invoke(String, Object[])	Chiama un metodo nell'oggetto Active Directory Domain Services nativo.
InvokeGet(String)	Ottiene una proprietà dall'oggetto Active Directory Domain Services nativo.
InvokeSet(String, Object[])	Imposta una proprietà sull'oggetto Active Directory Domain Services nativo.
MoveTo(DirectoryEntry, String)	Sposta l'oggetto DirectoryEntry nell'elemento padre specificato e ne modifica il nome nel valore specificato.
MoveTo(DirectoryEntry)	Sposta l'oggetto DirectoryEntry nell'elemento padre specificato.
RefreshCache()	Carica i valori delle proprietà per questo DirectoryEntry oggetto nella cache delle proprietà.
RefreshCache(String[])	Carica i valori delle proprietà specificate nella cache delle proprietà.
Rename(String)	Modifica il nome dell'oggetto DirectoryEntry .