IDictionary.Add(Object, Object) Metoda

Definice

Obor názvů:

System.Collections

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

IDictionary.cs

Přidá prvek se zadaným klíčem a hodnotou do objektu 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)

Parametry

key

Object

To Object use as the key of the element to add.

value

Object

Použije Object se jako hodnota prvku, který chcete přidat.

Výjimky

ArgumentNullException

key je null.

ArgumentException

Prvek se stejným klíčem již v objektu IDictionary existuje.

NotSupportedException

Je IDictionary jen pro čtení.

nebo

Má IDictionary pevnou velikost.

Příklady

Následující příklad kódu ukazuje, jak implementovat metodu Add . Tento příklad kódu je součástí většího příkladu uvedeného pro třídu IDictionary.

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

Poznámky

Vlastnost můžete také použít Item[] k přidání nových prvků nastavením hodnoty klíče, který neexistuje ve slovníku (například myCollection["myNonexistentKey"] = myValue). Pokud však zadaný klíč již ve slovníku existuje, nastavení Item[] vlastnosti přepíše starou hodnotu. Naproti tomu Add metoda neupravuje existující prvky.

Implementace se mohou lišit v tom, zda umožňují klíč být null.

Viz také

• Item[Object]