IDictionary<TKey,TValue>.Remove(TKey) Méthode

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Runtime.dll

Supprime l'élément avec la clé spécifiée d'IDictionary<TKey,TValue>.

public:
 bool Remove(TKey key);

public bool Remove (TKey key);

abstract member Remove : 'Key -> bool

Public Function Remove (key As TKey) As Boolean

Paramètres

key

TKey

Clé de l'élément à supprimer.

Retours

Boolean

true si la suppression de l'élément réussit ; sinon, false. Cette méthode retourne également false si key est introuvable dans le IDictionary<TKey,TValue> d'origine.

Exceptions

ArgumentNullException

key a la valeur null.

NotSupportedException

IDictionary<TKey,TValue> est en lecture seule.

Exemples

L’exemple de code suivant montre comment supprimer une paire clé/valeur d’un dictionnaire à l’aide de la Remove méthode .

Ce code fait partie d’un exemple plus large qui peut être compilé et exécuté. Consultez System.Collections.Generic.IDictionary<TKey,TValue>.

// Use the Remove method to remove a key/value pair.
Console::WriteLine("\nRemove(\"doc\")");
openWith->Remove("doc");

if (!openWith->ContainsKey("doc"))
{
    Console::WriteLine("Key \"doc\" is not found.");
}

// Use the Remove method to remove a key/value pair.
Console.WriteLine("\nRemove(\"doc\")");
openWith.Remove("doc");

if (!openWith.ContainsKey("doc"))
{
    Console.WriteLine("Key \"doc\" is not found.");
}

' Use the Remove method to remove a key/value pair.
Console.WriteLine(vbLf + "Remove(""doc"")")
openWith.Remove("doc")

If Not openWith.ContainsKey("doc") Then
    Console.WriteLine("Key ""doc"" is not found.")
End If

Remarques

Les implémentations peuvent varier dans la façon dont elles déterminent l’égalité des objets ; par exemple, la List<T> classe utilise Comparer<T>.Default, tandis que la Dictionary<TKey,TValue> classe permet à l’utilisateur de spécifier l’implémentation IComparer<T> à utiliser pour comparer des clés.

Voir aussi

• IsReadOnly