IDictionary.Add(Object, Object) Metoda

  • Reference

Definice

Obor názvů:
System.Collections
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Přidá prvek se zadaným klíčem a hodnotou k objektu IDictionary .

public:
 void Add(System::Object ^ key, System::Object ^ value);
public void Add (object key, 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

Použije Object se jako klíč elementu, který chcete přidat.

value
Object

Hodnota Object , která se má použít jako hodnota elementu, který se má 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 IDictionary pro třídu.

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

Poznámky

Vlastnost můžete také použít Item[] k přidání nových prvků nastavením hodnoty klíče, který ve slovníku neexistuje (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 můžou lišit v tom, jestli umožňují, aby klíč byl null.

Platí pro

Viz také