SortedDictionary<TKey,TValue>.Add(TKey, TValue) Yöntem

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kod:

System.Collections.dll

Kaynak:

SortedDictionary.cs

öğesine belirtilen anahtar ve değere SortedDictionary<TKey,TValue>sahip bir öğe ekler.

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)

Parametreler

key

TKey

Eklenecek öğenin anahtarı.

value

TValue

Eklenecek öğenin değeri. Değer başvuru türleri için olabilir null .

Uygulamalar

Add(TKey, TValue)

Özel durumlar

ArgumentNullException

key, null değeridir.

ArgumentException

içinde aynı anahtara sahip bir öğe zaten var SortedDictionary<TKey,TValue>.

Örnekler

Aşağıdaki kod örneği, dize anahtarlarıyla boş SortedDictionary<TKey,TValue> bir dize oluşturur ve bazı öğeleri eklemek için yöntemini kullanır Add . Örnek, yinelenen bir anahtar eklemeye çalışırken yönteminin bir ArgumentException oluşturduğunu Add gösterir.

Bu kod örneği, sınıfı için SortedDictionary<TKey,TValue> sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Özelliğini, içinde bulunmayan SortedDictionary<TKey,TValue>bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsinizItem[]; örneğin, myCollection["myNonexistentKey"] = myValue (Visual Basic'te). myCollection("myNonexistantKey") = myValue Ancak, belirtilen anahtar içinde SortedDictionary<TKey,TValue>zaten varsa, özelliğini ayarlamak Item[] eski değerin üzerine yazar. Buna karşılık, belirtilen anahtara Add sahip bir öğe zaten varsa yöntemi bir özel durum oluşturur.

Anahtar olamaz null, ancak değer türü bir başvuru türüyse TValue bir değer olabilir.

Bu yöntem bir O(log n) işlemidir ve burada n olur Count.

Ayrıca bkz.

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