SortedDictionary<TKey,TValue>.Add(TKey, TValue) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voegt een element met de opgegeven sleutel en waarde toe aan de SortedDictionary<TKey,TValue>.
public:
virtual void Add(TKey key, TValue value);public void Add(TKey key, TValue value);abstract member Add : 'Key * 'Value -> unit
override this.Add : 'Key * 'Value -> unitPublic Sub Add (key As TKey, value As TValue)Parameters
- key
- TKey
De sleutel van het element dat moet worden toegevoegd.
- value
- TValue
De waarde van het element dat moet worden toegevoegd. De waarde kan voor referentietypen zijn null .
Implementeringen
Uitzonderingen
key is null.
Er bestaat al een element met dezelfde sleutel in de SortedDictionary<TKey,TValue>.
Voorbeelden
In het volgende codevoorbeeld wordt een lege SortedDictionary<TKey,TValue> tekenreeks met tekenreekssleutels gemaakt en 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.
Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de SortedDictionary<TKey,TValue> klasse.
// Create a new sorted dictionary of strings, with string
// keys.
SortedDictionary<string, string> openWith =
new SortedDictionary<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 sorted dictionary of strings, with string
' keys.
Dim openWith As New SortedDictionary(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 bestaat in de SortedDictionary<TKey,TValue>; bijvoorbeeld myCollection["myNonexistentKey"] = myValue (in Visual Basic myCollection("myNonexistantKey") = myValue). Als de opgegeven sleutel echter al bestaat in de SortedDictionary<TKey,TValue>eigenschap, wordt de oude waarde overschreven door de Item[] eigenschap in te stellen. De methode genereert daarentegen Add een uitzondering als er al een element met de opgegeven sleutel bestaat.
Een sleutel kan niet zijn null, maar een waarde kan zijn, als het waardetype een verwijzingstype TValue is.
Deze methode is een O(log)-nbewerking, waarbij n .Count