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

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

public void Add(TKey key, TValue value);

abstract member Add : 'Key * 'Value -> unit
override this.Add : 'Key * 'Value -> unit

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

Paramètres

Implémente

Exceptions

Exemples

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

Cet exemple de code fait partie d’un exemple plus grand fourni pour la Dictionary<TKey,TValue> classe.

// Create a new dictionary of strings, with string keys.
//
Dictionary<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.
let openWith = 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")
with :? ArgumentException ->
    printfn "An element with Key = \"txt\" already exists."

' Create a new dictionary of strings, with string keys.
'
Dim openWith As 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 Dictionary<TKey,TValue>; par exemple ( myCollection[myKey] = myValue en Visual Basic, myCollection(myKey) = myValue). Toutefois, si la clé spécifiée existe déjà dans le Dictionary<TKey,TValue>fichier , la définition de la Item[] propriété remplace l’ancienne valeur. En revanche, la Add méthode lève une exception si une valeur avec la clé spécifiée existe déjà.

Si la Count valeur de propriété est déjà égale à la capacité, la capacité de l’élément Dictionary<TKey,TValue> est augmentée en réaffectant automatiquement le tableau interne et les éléments existants sont copiés dans le nouveau tableau avant l’ajout du nouvel élément.

Une clé ne peut pas être null, mais une valeur peut être, s’il s’agit TValue d’un type référence.

Si Count elle est inférieure à la capacité, cette méthode approche une opération O(1). Si la capacité doit être augmentée pour prendre en charge le nouvel élément, cette méthode devient une opération O(n), où n est Count.

Voir aussi

• Remove(TKey)
• Item[TKey]
• Add(TKey, TValue)