IDictionary.Add(Object, Object) Metod

Definition

Namnområde:
System.Collections
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
netstandard.dll

Lägger till ett element med den angivna nyckeln och värdet i IDictionary objektet.

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)

Parametrar

key
Object

Att Object använda som nyckel för det element som ska läggas till.

value
Object

Att Object använda som värde för elementet som ska läggas till.

Undantag

ArgumentNullException

key är null.

ArgumentException

Det finns redan ett element med samma nyckel i objektet IDictionary .

NotSupportedException

Är IDictionary skrivskyddad.

-eller-

Har IDictionary en fast storlek.

Exempel

Följande kodexempel visar hur du implementerar Add metoden. Det här kodexemplet är en del av ett större exempel för IDictionary klassen.

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

Kommentarer

Du kan också använda Item[] egenskapen för att lägga till nya element genom att ange värdet för en nyckel som inte finns i ordlistan (till exempel myCollection["myNonexistentKey"] = myValue). Men om den angivna nyckeln redan finns i ordlistan skriver egenskapen Item[] över det gamla värdet. Metoden ändrar däremot Add inte befintliga element.

Implementeringar kan variera beroende på om de tillåter att nyckeln är null.

Gäller för

Se även