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

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt een lege Dictionary<TKey,TValue> reeks tekenreeksen gemaakt, met gehele getallen en wordt deze geopend via de IDictionary<TKey,TValue> interface. In het codevoorbeeld wordt de Add methode gebruikt om enkele elementen toe te voegen. In het voorbeeld ziet u dat de Add methode een ArgumentException dubbele sleutel genereert bij het toevoegen van een dubbele sleutel.

Deze code maakt deel uit van een groter voorbeeld dat kan worden gecompileerd en uitgevoerd. Zie 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

Opmerkingen

U kunt ook de eigenschap Item[] gebruiken om nieuwe elementen toe te voegen door de waarde in te stellen van een sleutel die niet in de woordenlijst bestaat; bijvoorbeeld myCollection["myNonexistentKey"] = myValue in C# (myCollection("myNonexistentKey") = myValue in Visual Basic). Als de opgegeven sleutel echter al bestaat in de woordenlijst, wordt de oude waarde overschreven door de Item[] eigenschap in te stellen. De methode wijzigt daarentegen Add geen bestaande elementen.

Implementaties kunnen variëren in hoe ze gelijkheid van objecten bepalen; De klasse gebruikt Comparer<T>.DefaultbijvoorbeeldList<T>, terwijl de Dictionary<TKey,TValue> klasse de gebruiker toestaat de IComparer<T> implementatie op te geven die moet worden gebruikt voor het vergelijken van sleutels.

Implementaties kunnen variëren in of ze toestaan key te zijn null.

Zie ook

• Item[TKey]
• IsReadOnly