Establecer propiedades con varios valores

En este tema se muestra cómo establecer propiedades con varios valores mediante los siguientes métodos:

• Add es un método de PropertyValueCollection que anexa un valor de propiedad adicional a una propiedad con varios valores.
• AddRange es un método de PropertyValueCollection que anexa varios valores a una propiedad con varios valores.
• Insert es un método de PropertyValueCollection que inserta un valor de propiedad por su índice en una propiedad con varios valores. Esta posición sólo se establece en el cliente; cuando la confirma en el directorio, no hay garantía de que se guardará en esta posición de índice en Active Directory.

También puede establecer valores utilizando una matriz indizada.

Al establecer un valor de propiedad, los datos se guardan en la caché de propiedades. Para escribir los nuevos datos en el directorio, llame al método CommitChanges. Para obtener más información, vea Caché de propiedades.

En el ejemplo de código siguiente se muestra cómo se utiliza el método AddRange.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
ent.Properties("otherTelephone").AddRange(New Object() {"(425) 523 1462", "(523) 125 6321"})
ent.CommitChanges()

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
ent.Properties["otherTelephone"].AddRange(new object[] {"(425) 523 1462","(523) 125 6321"});
ent.CommitChanges();

En el ejemplo de código siguiente se muestra cómo se utiliza el método Insert.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
ent.Properties("otherTelephone").Insert(2, "525 623 5423")
ent.CommitChanges()

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
ent.Properties["otherTelephone"].Insert(2, "525 623 5423");
ent.CommitChanges();

El siguiente ejemplo de código muestra cómo se utiliza una matriz para establecer un valor en una propiedad con varios valores.

Dim ent As New DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com")
ent.Properties("otherTelephone")(0) = "425 263 6234"
ent.CommitChanges()

DirectoryEntry ent = new DirectoryEntry("LDAP://Fabrikam/CN=My Username,CN=Users,DC=Fabrikam,DC=com");
ent.Properties["otherTelephone"][0] = "425 263 6234";
ent.CommitChanges();

Consulte también

Referencia

System.DirectoryServices
PropertyValueCollection
DirectoryEntry

Conceptos

Propiedades con varios valores

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.