IDictionary.Add(Object, Object) Méthode

Définition

Espace de noms:
System.Collections
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.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

Il IDictionary est en lecture seule.

-ou-

La IDictionary taille est 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 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é null.

S’applique à

Voir aussi