Oggetti DirectoryEntry

In System.DirectoryServices, ogni oggetto nella directory è rappresentato dall'oggetto DirectoryEntry. DirectoryEntry crea un oggetto voce in memoria; l'oggetto non viene creato effettivamente nella directory finché non viene chiamato il metodo CommitChanges. Il vantaggio è che è possibile recuperare le informazioni della directory per l'accesso da un'applicazione client e leggere o modificare tali informazioni in locale prima di riconnettersi al server per salvare le informazioni modificate nella directory. Ciò consente al server di operare alla massima efficienza.

Ogni risorsa di rete è rappresentata nella directory come un oggetto e ogni oggetto directory, come detto prima, è rappresentato come un oggetto DirectoryEntry nell'applicazione client.

Gli oggetti voce di directory hanno le caratteristiche seguenti:

• Name. Il nome dell'oggetto è conosciuto anche come nome distinto relativo (RDN, Relative Distinguished Name). Il formato del nome RDN utilizza la sintassi chiave=valore. Ad esempio, nel diagramma seguente, il nome RDN per un oggetto utente è CN=Jeff Smith. Notare che non sono utilizzati spazi.
• Parent. Gli oggetti di rete sono gerarchici e hanno un oggetto padre finché non si raggiunge l'oggetto radice, che è l'oggetto dominio, talvolta denominato elemento principale del dominio, all'inizio della gerarchia.
• Path. Il percorso dell'oggetto directory è conosciuto anche come nome distinto (DN, Distinguished Name). Il nome distinto viene costruito con il nome dell'oggetto preceduto dai nomi di ogni oggetto padre fino all'oggetto radice. Ad esempio, per l'oggetto utente CN=Jeff Smith, il nome DN inizia con l'oggetto radice e segue il percorso dell'oggetto utente, in questo modo: DC=Fabrikam,DC=COM,OU=Sales,CN=Jeff Smith. I percorsi utilizzano una sintassi definita dalla specifica LDAP. Per ulteriori informazioni sulla sintassi appropriata per il percorso, vedere Stringhe di associazione. Il percorso viene utilizzato in una stringa di associazione creata con l'oggetto DirectoryEntry.

Mentre le informazioni precedenti sono valide per qualsiasi oggetto directory LDAP a cui ci si connette utilizzando System.DirectoryServices, alcune informazioni sono specifiche di Servizi di dominio Active Directory. Una caratteristica degli oggetti di Servizi di dominio Active Directory è che tali oggetti devono contenere un GUID (Globally Unique IDentifier). Mentre è possibile modificare i valori dei diversi attributi per l'oggetto, il GUID non è modificabile.

Nell'esempio di codice riportato di seguito viene illustrato come creare un DirectoryEntry e scriverne percorso, nome e GUID. In questo esempio, DirectoryEntry è associato alla radice del dominio a cui questo utente attualmente è connesso.

Imports System.DirectoryServices
'...
Dim entry As New DirectoryEntry()
Console.WriteLine(entry.Path)
Console.WriteLine(entry.Name)
Console.WriteLine(entry.Guid)

using System.DirectoryServices;
//...
DirectoryEntry entry = new DirectoryEntry();
Console.WriteLine(entry.Path);
Console.WriteLine(entry.Name);
Console.WriteLine(entry.Guid);

Vedere anche

Riferimenti

System.DirectoryServices
DirectoryEntry

Concetti

Introduzione a System.DirectoryServices
Stringhe di associazione

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Tutti i diritti riservati.