DirectoryEntry Classe

Definizione

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

public ref class DirectoryEntry : System::ComponentModel::Component
public 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.Component
type 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 Component
Public Class DirectoryEntry
Inherits Component
Ereditarietà
Attributi

Commenti

Usare 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. Includono la creazione, l'eliminazione, la ridenominazione, lo spostamento di un nodo figlio e l'enumerazione dei figli. Dopo aver modificato un nodo, è necessario eseguire il commit delle modifiche per salvarle nell'albero. Per altre informazioni, vedere la proprietà CommitChanges.

DirectoryEntry può essere usato per accedere a voci regolari e alcune, ma non tutte, le informazioni provenienti 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 quando vengono assunti nuovi dipendenti e oggetti come stampanti di rete e computer vengono aggiunti. La tecnologia Active Directory Service Interfaces (ADSI) offre modi per aggiungere questi oggetti a livello di codice all'albero delle directory.

Per creare una voce di directory nella gerarchia, usare la Children proprietà . La Children proprietà è una raccolta che fornisce un metodo, tramite il quale si aggiunge un Add nodo alla raccolta direttamente sotto il nodo padre a cui è attualmente associato. 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 vuole 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 Active Directory Domain Services. Alcuni dei provider correnti sono Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Directory Service (NDS) e WinNT.

Nota

Si presuppone che si abbia una comprensione 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)

Si applica a