IDictionary<TKey,TValue>.Add(TKey, TValue) Metoda

Definice

Obor názvů:

System.Collections.Generic

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

IDictionary.cs

Přidá prvek se zadaným klíčem a hodnotou do objektu IDictionary<TKey,TValue>.

public:
 void Add(TKey key, TValue value);

public void Add(TKey key, TValue value);

abstract member Add : 'Key * 'Value -> unit

Public Sub Add (key As TKey, value As TValue)

Parametry

key

TKey

Objekt, který se má použít jako klíč elementu, který chcete přidat.

value

TValue

Objekt, který se má použít jako hodnota elementu, který chcete přidat.

Výjimky

ArgumentNullException

key je null.

ArgumentException

Prvek se stejným klíčem již v objektu IDictionary<TKey,TValue>.

NotSupportedException

Je IDictionary<TKey,TValue> jen pro čtení.

Příklady

Následující příklad kódu vytvoří prázdné Dictionary<TKey,TValue> řetězce s celočíselné klíče a přistupuje k němu prostřednictvím IDictionary<TKey,TValue> rozhraní. Příklad kódu používá metodu Add k přidání některých prvků. Příklad ukazuje, že Add metoda vyvolá ArgumentException při pokusu o přidání duplicitního klíče.

Tento kód je součástí většího příkladu, který lze zkompilovat a spustit. Viz System.Collections.Generic.IDictionary<TKey,TValue>.

// Create a new dictionary of strings, with string keys,
// and access it through the IDictionary generic interface.
IDictionary<string, string> openWith =
    new Dictionary<string, string>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}

' Create a new dictionary of strings, with string keys, 
' and access it through the IDictionary generic interface.
Dim openWith As IDictionary(Of String, String) = _
    New Dictionary(Of String, String)

' Add some elements to the dictionary. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Poznámky

Pomocí vlastnosti Item[] můžete přidat nové prvky nastavením hodnoty klíče, který ve slovníku neexistuje; například myCollection["myNonexistentKey"] = myValue v jazyce C# (myCollection("myNonexistentKey") = myValue v Visual Basic). 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, jak určují rovnost objektů; Například třída List<T> používá , zatímco Comparer<T>.Default třída umožňuje uživateli určit implementaciDictionary<TKey,TValue>, která se má použít pro IComparer<T>porovnávání klíčů.

Implementace se mohou lišit v tom, zda mohou key být null.

Viz také

• Item[TKey]
• IsReadOnly