PropertyValueCollection.Remove(Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rimuove il valore specificato di una proprietà dalla raccolta.
public:
void Remove(System::Object ^ value);public void Remove (object value);public void Remove (object? value);member this.Remove : obj -> unitPublic Sub Remove (value As Object)Parametri
- value
- Object
Valore della proprietà da rimuovere.
Eccezioni
Il valore della proprietà è un riferimento Null (Nothing in Visual Basic).
Si è verificato un errore durante la chiamata all'interfaccia sottostante.
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 usa un valore di 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, utilizzata per archiviare gli elementi DNWithString, ha 2 proprietà stringa che rappresentano l'elemento). Il modo per rimuovere tali elementi consiste nel trovare l'oggetto nell'insieme (eseguendo il ciclo di tutti gli elementi), quindi chiamare la Remove funzione con il puntatore dell'oggetto appena trovato. Questo argomento è illustrato nell'esempio seguente.
