Dictionary<TKey,TValue>.Remove Méthode

Définition

Espace de noms:

System.Collections.Generic

Assemblys:

netstandard.dll, System.Collections.dll

Surcharges

Nom	Description
Remove(TKey)	Supprime la valeur avec la clé spécifiée du Dictionary<TKey,TValue>.
Remove(TKey, TValue)	Supprime la valeur avec la clé spécifiée de l’élément Dictionary<TKey,TValue>et copie l’élément dans le value paramètre.

Remove(TKey)

Source:

Dictionary.cs

Supprime la valeur avec la clé spécifiée du Dictionary<TKey,TValue>.

public:
 virtual bool Remove(TKey key);

public bool Remove(TKey key);

abstract member Remove : 'Key -> bool
override this.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 l’élément est correctement trouvé et supprimé ; sinon, false. Cette méthode retourne false si key elle est introuvable dans le Dictionary<TKey,TValue>.

Implémente

Remove(TKey)

Exceptions

ArgumentNullException

key a la valeur null.

Exemples

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

Cet exemple de code fait partie d’un exemple plus grand fourni pour la Dictionary<TKey,TValue> classe (openWith est le nom du dictionnaire utilisé dans cet exemple).

// 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.
printfn "\nRemove(\"doc\")"
openWith.Remove "doc" |> ignore

if openWith.ContainsKey "doc" |> not then
    printfn "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

Si le Dictionary<TKey,TValue> fichier ne contient pas d’élément avec la clé spécifiée, le Dictionary<TKey,TValue> reste inchangé. Aucune exception n’est générée.

Cette méthode approche une opération O(1).

.NET Core 3.0+ uniquement : cette méthode de mutation peut être appelée en toute sécurité sans invalider les énumérateurs actifs sur l’instance Dictionary<TKey,TValue> . Cela n’implique pas la sécurité des threads.

Voir aussi

• Add(TKey, TValue)
• Remove(TKey)

Remove(TKey, TValue)

Source:

Dictionary.cs

Supprime la valeur avec la clé spécifiée de l’élément Dictionary<TKey,TValue>et copie l’élément dans le value paramètre.

public:
 bool Remove(TKey key, [Runtime::InteropServices::Out] TValue % value);

public bool Remove(TKey key, out TValue value);

member this.Remove : 'Key * 'Value -> bool

Public Function Remove (key As TKey, ByRef value As TValue) As Boolean

Paramètres

key

TKey

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

value

TValue

Élément supprimé.

Retours

Boolean

true si l’élément est correctement trouvé et supprimé ; sinon, false.

Exceptions

ArgumentNullException

key a la valeur null.