Dictionary<TKey,TValue>.TryAdd(TKey, TValue) Méthode

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Source:

Dictionary.cs

Tente d’ajouter la clé et la valeur spécifiées au dictionnaire.

public:
 bool TryAdd(TKey key, TValue value);

public bool TryAdd (TKey key, TValue value);

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

Public Function TryAdd (key As TKey, value As TValue) As Boolean

Paramètres

key

TKey

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

value

TValue

Valeur de l'élément à ajouter. Elle peut être null.

Retours

Boolean

true si la paire clé/valeur a été ajoutée au dictionnaire ; sinon, false.

Exceptions

ArgumentNullException

key a la valeur null.

Remarques

Contrairement à la Add méthode, cette méthode ne lève pas d’exception si l’élément avec la clé donnée existe dans le dictionnaire. Contrairement à l’indexeur Dictionary, TryAdd ne remplace pas l’élément si l’élément avec la clé donnée existe dans le dictionnaire. Si la clé existe déjà, TryAdd ne fait rien et retourne false.