IDictionary.Add(Object, Object) Methode

Definition

Namespace:
System.Collections
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Fügt dem Objekt ein Element mit dem bereitgestellten Schlüssel und Wert hinzu 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)

Parameter

key
Object

Wird Object als Schlüssel des hinzuzufügenden Elements verwendet.

value
Object

Der Object Wert, der als Wert des hinzuzufügenden Elements verwendet werden soll.

Ausnahmen

ArgumentNullException

key ist null.

ArgumentException

Ein Element mit demselben Schlüssel ist bereits im IDictionary Objekt vorhanden.

NotSupportedException

Dies IDictionary ist schreibgeschützt.

-oder-

Die IDictionary Größe hat eine feste Größe.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Add Methode implementiert wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die IDictionary Klasse bereitgestellt wird.

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

Hinweise

Sie können die Item[] Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der nicht im Wörterbuch vorhanden ist (z. B myCollection["myNonexistentKey"] = myValue. ). Wenn der angegebene Schlüssel jedoch bereits im Wörterbuch vorhanden ist, überschreibt das Festlegen der Item[] Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add Methode keine vorhandenen Elemente.

Implementierungen können variieren, ob sie den Schlüssel zulassen null.

Gilt für:

Weitere Informationen