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

Definition

Namnområde:
System.Collections.Generic
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<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)

Parametrar

key
TKey

Det objekt som ska användas som nyckel för det element som ska läggas till.

value
TValue

Det objekt som ska användas 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 IDictionary<TKey,TValue>.

NotSupportedException

Är IDictionary<TKey,TValue> skrivskyddad.

Exempel

I följande kodexempel skapas en tom Dictionary<TKey,TValue> sträng, med heltalsnycklar, och den nås via IDictionary<TKey,TValue> gränssnittet. Kodexemplet Add använder metoden för att lägga till vissa element. Exemplet visar att Add metoden genererar en ArgumentException när du försöker lägga till en dubblettnyckel.

Den här koden är en del av ett större exempel som kan kompileras och köras. Se även 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

Kommentarer

Du kan också använda egenskapen Item[] 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 i C# (myCollection("myNonexistentKey") = myValue i Visual Basic). 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 i hur de bestämmer objektens likhet. Klassen använder Comparer<T>.Defaulttill exempel List<T> , medan Dictionary<TKey,TValue> klassen tillåter att användaren anger vilken implementering som IComparer<T> ska användas för att jämföra nycklar.

Implementeringarna kan variera beroende på om de tillåter key att de är null.

Gäller för

Se även