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

Definicja

Przestrzeń nazw:

System.Collections.Generic

Zestaw:

System.Collections.dll

Źródło:

SortedDictionary.cs

Dodaje element z określonym kluczem i wartością do elementu 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)

Parametry

key

TKey

Klucz elementu do dodania.

value

TValue

Wartość elementu do dodania. Wartość może być null dla typów referencyjnych.

Implementuje

Add(TKey, TValue)

Wyjątki

ArgumentNullException

key to null.

ArgumentException

Element o tym samym kluczu już istnieje w pliku SortedDictionary<TKey,TValue>.

Przykłady

Poniższy przykład kodu tworzy puste SortedDictionary<TKey,TValue> ciągi z kluczami ciągów i używa Add metody w celu dodania niektórych elementów. W przykładzie Add pokazano, że metoda zgłasza błąd ArgumentException podczas próby dodania zduplikowanego klucza.

Ten przykład kodu jest częścią większego przykładu udostępnionego SortedDictionary<TKey,TValue> dla klasy .

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

Uwagi

Możesz również użyć Item[] właściwości , aby dodać nowe elementy, ustawiając wartość klucza, który nie istnieje w elemecie SortedDictionary<TKey,TValue>, na przykład myCollection["myNonexistentKey"] = myValue (w Visual Basic, myCollection("myNonexistantKey") = myValue). Jeśli jednak określony klucz już istnieje w SortedDictionary<TKey,TValue>obiekcie , ustawienie Item[] właściwości zastępuje starą wartość. Z kolei metoda zgłasza wyjątek, Add jeśli element z określonym kluczem już istnieje.

Klucz nie może mieć nullwartości , ale wartość może być, jeśli typ wartości jest typem TValue referencyjnym.

Ta metoda jest operacją O(log n), gdzie n to Count.

Zobacz też

• Remove(TKey)
• Item[TKey]
• Add(TKey, TValue)