IDictionary.Add(Object, Object) Méthode

Définition

Espace de noms:

System.Collections

Assembly:

System.Runtime.dll

Ajoute un élément avec la clé et la valeur fournies à l'objet IDictionary.

public:
 void Add(System::Object ^ key, System::Object ^ value);

public void Add (object key, object? value);

abstract member Add : obj * obj -> unit

Public Sub Add (key As Object, value As Object)

Paramètres

key

Object

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

value

Object

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

Exceptions

ArgumentNullException

key a la valeur null.

ArgumentException

Un élément avec la même clé existe déjà dans l'objet IDictionary.

NotSupportedException

IDictionary est en lecture seule.

- ou -

IDictionary est de taille fixe.

Exemples

L’exemple de code suivant montre comment implémenter la Add méthode . Cet exemple de code fait partie d’un exemple plus grand fourni pour la IDictionary classe .

public:
    virtual void Add(Object^ key, Object^ value)
    {
        // Add the new key/value pair even if this key already exists
        // in the dictionary.
        if (itemsInUse == items->Length)
        {
            throw gcnew InvalidOperationException
                ("The dictionary cannot hold any more items.");
        }
        items[itemsInUse++] = gcnew DictionaryEntry(key, value);
    }

public void Add(object key, object value)
{
    // Add the new key/value pair even if this key already exists in the dictionary.
    if (ItemsInUse == items.Length)
        throw new InvalidOperationException("The dictionary cannot hold any more items.");
    items[ItemsInUse++] = new DictionaryEntry(key, value);
}

Public Sub Add(ByVal key As Object, ByVal value As Object) Implements IDictionary.Add

    ' Add the new key/value pair even if this key already exists in the dictionary.
    If ItemsInUse = items.Length Then
        Throw New InvalidOperationException("The dictionary cannot hold any more items.")
    End If
    items(ItemsInUse) = New DictionaryEntry(key, value)
    ItemsInUse = ItemsInUse + 1
End Sub

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). 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 selon qu’elles autorisent la clé à être null.

Voir aussi

• Item[Object]