Leer propiedades de objetos de directorio

Cuando recupera valores de propiedades de un objeto, los datos se devuelven como una colección enumerable, incluso si únicamente se devuelve un solo valor. Esta operación se realiza con Properties, que es una propiedad de la clase DirectoryEntry. Properties devuelve un objeto PropertyCollection. Los valores de las propiedades a las que se hace referencia en PropertyCollection se almacenan en el objeto PropertyValueCollection.

Nota:
No se admite el uso de la propiedad Properties con la extensión de cliente de Active Directory (DSClient) para Windows NT 4.0.

Los valores de las propiedades de una colección se leen utilizando la propiedad Value del objeto PropertyValueCollection. Si sólo hay un valor en la colección, se devuelve como una representación del valor del objeto.

Para obtener acceso al valor de una propiedad de objeto, proporcione el nombre de la propiedad que utiliza la sintaxis mostrada en el siguiente ejemplo de código.

DirectoryEntry.Properties("givenName").Value

DirectoryEntry.Properties["givenName"].Value;

En este ejemplo, el código tendrá acceso a la propiedad givenName, que es el nombre para mostrar LDAP de una propiedad del objeto user en Active Directory y otros directorios LDAP. Para obtener acceso a una propiedad específica en el directorio, proporcione el nombre LDAP para mostrar esa propiedad en la aplicación. Para obtener más información acerca de la propiedad givenName y el objeto de usuario de Active Directory, vea el tema givenName y el tema Usuario de la biblioteca de MSDN en https://go.microsoft.com/fwlink/?LinkID=27252.

El siguiente ejemplo de código muestra cómo puede utilizar la colección Properties para leer un solo valor.

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

Consulte también

Referencia

System.DirectoryServices
DirectoryEntry
PropertyCollection
PropertyValueCollection

Conceptos

Propiedades de objetos de directorio

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.