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 propriété à supprimer.
Exceptions
La valeur de propriété est une référence Null (Nothing dans Visual Basic).
Une erreur s’est produite pendant l’appel à l’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
Lorsque vous utilisez 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 (comme classe COM DNWithString, 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 de tels é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. Ceci est illustré dans l’exemple ci-dessous.
