PropertyValueCollection.Remove(Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Supprime une valeur de propriété spécifiée de cette collection.
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)Paramètres
- value
- Object
Valeur de la propriété à supprimer.
Exceptions
La valeur par défaut est une référence null (Nothing en Visual Basic).
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.
