PropertyValueCollection.Remove(Object) Méthode

Définition

Espace de noms:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paquet:

System.DirectoryServices v8.0.0

Source:

PropertyValueCollection.cs

Supprime une valeur de propriété spécifiée de cette collection.

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

public void Remove (object? value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Paramètres

value

Object

Valeur de la propriété à supprimer.

Exceptions

ArgumentNullException

La valeur par défaut est une référence null (Nothing en Visual Basic).

COMException

Une erreur s’est produite lors de l’appel d’une interface sous-jacente.

Exemples

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

Remarques

Lors de l’utilisation d’une valeur de propriété de chaîne à valeurs multiples, la Remove méthode supprime correctement l’élément correct. Toutefois, l’identification des éléments corrects par nom est difficile avec une valeur de propriété DNWithString à valeurs multiples (car la classe COM DNWithString, qui est utilisée pour stocker les éléments DNWithString, a 2 propriétés de chaîne représentant l’élément). La façon de supprimer ces éléments consiste à rechercher l’objet dans la collection (en bouclant tous les éléments), puis à appeler la Remove fonction avec le pointeur de l’objet que vous venez de trouver. Cela est illustré dans l’exemple ci-dessous.