PropertyValueCollection.Remove(Object) Método

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Paquete:

System.DirectoryServices v8.0.0

Source:

PropertyValueCollection.cs

Quita un valor de propiedad especificado de la 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 propiedad es una referencia nula (Nothing en Visual Basic).

COMException

Se produjo un 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, identificar 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 (haciendo un bucle de 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 ejemplo siguiente.