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

Definition

Namnområde:
System.Collections.Generic
Sammansättningar:
System.dll, System.Collections.dll
Sammansättning:
System.dll
Sammansättning:
System.Collections.dll
Sammansättning:
netstandard.dll

Lägger till ett element med den angivna nyckeln och värdet i 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 -> unit
Public Sub Add (key As TKey, value As TValue)

Parametrar

key
TKey

Nyckeln för elementet som ska läggas till.

value
TValue

Värdet för elementet som ska läggas till. Värdet kan vara null för referenstyper.

Implementeringar

Add(TKey, TValue)

Undantag

ArgumentNullException

key är null.

ArgumentException

Det finns redan ett element med samma nyckel i SortedDictionary<TKey,TValue>.

Exempel

I följande kodexempel skapas en tom SortedDictionary<TKey,TValue> sträng med strängnycklar och metoden används Add 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.

Det här kodexemplet är en del av ett större exempel för SortedDictionary<TKey,TValue> klassen.

// 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

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 SortedDictionary<TKey,TValue>. till exempel myCollection["myNonexistentKey"] = myValue (i Visual Basic myCollection("myNonexistantKey") = myValue). Men om den angivna nyckeln redan finns i SortedDictionary<TKey,TValue>, skriver egenskapen Item[] över det gamla värdet. Metoden genererar däremot Add ett undantag om ett element med den angivna nyckeln redan finns.

En nyckel kan inte vara null, men ett värde kan vara om värdetypen TValue är en referenstyp.

Den här metoden är en O(log n)-åtgärd, där n är Count.

Gäller för

Se även