PropertyValueCollection.Remove(Object) Método

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Quita un valor de propiedad especificado de esta colección.

public:
 void Remove(System::Object ^ value);

public void Remove(object value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Parámetros

value

Object

Valor de propiedad que se va a quitar.

Excepciones

ArgumentNullException

El valor de la propiedad es una referencia nula (Nothing en Visual Basic).

COMException

Error durante la llamada a la interfaz subyacente.

Ejemplos

// Bind to the AD object
DirectoryEntry myUser = new DirectoryEntry("LDAP://AdServer:389/CN=MyUsername,CN=Users,DC=contoso,DC=com");

// Get the attribute
PropertyValueCollection testAttribute = myUser.Properties["someAttribute"];

// Find the item in the collection that we want to delete
DNWithString dnwsItemToRemove = null;
foreach (DNWithString dnwsItem in testAttribute)
{
    if (dnwsItem.StringValue.Equals("SomeValue"))
    {
        dnwsItemToRemove = dnwsItem;
        break;
    }
}

// Delete it
testAttribute.Remove(dnwsItemToRemove);

// Store the data
myUser.CommitChanges();

Comentarios

Al trabajar con un valor de propiedad de cadena con varios valores, el Remove método quitará correctamente el elemento correcto. Sin embargo, la identificación de los elementos correctos por nombre es difícil con un valor de propiedad DNWithString multivalor (como la clase COM DNWithString, que se usa para almacenar los elementos DNWithString, tiene dos propiedades de cadena que representan el elemento). La manera de quitar estos elementos es buscar el objeto en la colección (mediante el bucle thru todos los elementos) y, a continuación, llamar a la Remove función con el puntero del objeto que acaba de encontrar. Esto se muestra en el siguiente ejemplo.