PropertyValueCollection.Remove(Object) Metodo

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

public void Remove(object? value);

public void Remove(object value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Parametri

Eccezioni

Esempio

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

Commenti

Quando si utilizza un valore della proprietà stringa multivalore, il Remove metodo rimuoverà correttamente l'elemento corretto. Tuttavia, l'identificazione degli elementi corretti in base al nome è difficile con un valore di proprietà DNWithString multivalore (come classe COM DNWithString, che viene usata per archiviare gli elementi DNWithString, dispone di 2 proprietà stringa che rappresentano l'elemento). Il modo per rimuovere tali elementi consiste nel trovare l'oggetto nell'insieme (eseguendo un ciclo di tutti gli elementi), quindi chiamare la Remove funzione con il puntatore dell'oggetto appena trovato. L'esempio di seguito illustra questo concetto.