PropertyValueCollection.Remove(Object) Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacchetto:

System.DirectoryServices v8.0.0

Origine:

PropertyValueCollection.cs

Rimuove il valore specificato di una proprietà dalla raccolta.

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

public void Remove (object? value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Parametri

value

Object

Valore della proprietà da rimuovere.

Eccezioni

ArgumentNullException

Il valore della proprietà è un riferimento Null (Nothing in Visual Basic).

COMException

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.