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

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Runtime.dll

Ajoute un élément avec la clé et la valeur fournies à IDictionary<TKey,TValue>.

public:
 void Add(TKey key, TValue value);

public void Add (TKey key, TValue value);

abstract member Add : 'Key * 'Value -> unit

Public Sub Add (key As TKey, value As TValue)

Paramètres

key

TKey

Objet à utiliser comme clé de l'élément à ajouter.

value

TValue

Objet à utiliser comme valeur de l'élément à ajouter.

Exceptions

ArgumentNullException

key a la valeur null.

ArgumentException

Un élément possédant la même clé existe déjà dans IDictionary<TKey,TValue>.

NotSupportedException

IDictionary<TKey,TValue> est en lecture seule.

Exemples

L’exemple de code suivant crée un vide Dictionary<TKey,TValue> de chaînes, avec des clés entières, et y accède via l’interface IDictionary<TKey,TValue> . L’exemple de code utilise la Add méthode pour ajouter des éléments. L’exemple montre que la Add méthode lève un ArgumentException lors de la tentative d’ajout d’une clé en double.

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

// Create a new dictionary of strings, with string keys,
// and access it through the IDictionary generic interface.
IDictionary<String^, String^>^ openWith =
    gcnew Dictionary<String^, String^>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith->Add("txt", "notepad.exe");
openWith->Add("bmp", "paint.exe");
openWith->Add("dib", "paint.exe");
openWith->Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}

// Create a new dictionary of strings, with string keys,
// and access it through the IDictionary generic interface.
IDictionary<string, string> openWith =
    new Dictionary<string, string>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}

' Create a new dictionary of strings, with string keys, 
' and access it through the IDictionary generic interface.
Dim openWith As IDictionary(Of String, String) = _
    New Dictionary(Of String, String)

' Add some elements to the dictionary. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Remarques

Vous pouvez également utiliser la Item[] propriété pour ajouter de nouveaux éléments en définissant la valeur d’une clé qui n’existe pas dans le dictionnaire, par exemple, myCollection["myNonexistentKey"] = myValue en C# (myCollection("myNonexistentKey") = myValue en Visual Basic). Toutefois, si la clé spécifiée existe déjà dans le dictionnaire, la définition de la Item[] propriété remplace l’ancienne valeur. En revanche, la Add méthode ne modifie pas les éléments existants.

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.

Les implémentations peuvent varier selon qu’elles permettent key d’être null.

Voir aussi

• Item[TKey]
• IsReadOnly