Lecture des propriétés d'objets d'annuaire

Lorsque vous récupérez les valeurs des propriétés pour un objet, les données sont retournées en tant que collection énumérable, même si une seule valeur est retournée. Cette opération est effectuée avec la propriété Properties qui se trouve dans la classe DirectoryEntry. Properties retourne un objet PropertyCollection. Les valeurs des propriétés référencées dans PropertyCollection sont stockées dans l'objet PropertyValueCollection.

Remarque :
La propriété Properties ne peut pas être utilisée avec l'extension du client Active Directory (DSClient) pour Windows NT 4.0.

Les valeurs des propriétés dans une collection sont lues à l'aide de la propriété Value depuis l'objet PropertyValueCollection. S'il n'existe qu'une seule valeur dans la collection, elle est retournée comme représentation d'objet de la valeur.

Pour accéder à la valeur d'une propriété d'un objet, indiquez le nom de la propriété en utilisant la syntaxe indiquée dans l'exemple de code suivant.

DirectoryEntry.Properties("givenName").Value

DirectoryEntry.Properties["givenName"].Value;

Dans cet exemple, le code accède à la propriété givenName, qui est le nom complet LDAP pour une propriété dans l'objet utilisateur dans les services de domaine Active Directory et dans d'autres annuaires LDAP. Pour accéder à une propriété spécifique dans l'annuaire, indiquez le nom complet LDAP pour cette propriété dans votre application. Pour plus d'informations sur la propriété givenName et l'objet utilisateur d'Active Directory, consultez les rubriques givenName et User dans MSDN Library à l'adresse https://go.microsoft.com/fwlink/?LinkID=27252 (page pouvant être en anglais).

L'exemple de code suivant montre comment vous pouvez utiliser la collection Properties pour lire une valeur unique.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
Dim name As [string] = ent.Properties("sn").Value.ToString()
Console.WriteLine(name)

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
string name = ent.Properties["sn"].Value.ToString();
Console.WriteLine(name);

Voir aussi

Référence

System.DirectoryServices
DirectoryEntry
PropertyCollection
PropertyValueCollection

Concepts

Propriétés des objets d'annuaire

Send comments about this topic to Microsoft.

Copyright © 2007 par Microsoft Corporation. Tous droits réservés.