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

Definisi

Ruang nama:

System.Collections.Generic

Rakitan:

System.Collections.dll

Sumber:

SortedDictionary.cs

Menambahkan elemen dengan kunci dan nilai yang ditentukan ke SortedDictionary<TKey,TValue>dalam .

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)

Parameter

key

TKey

Kunci elemen yang akan ditambahkan.

value

TValue

Nilai elemen yang akan ditambahkan. Nilainya bisa null untuk jenis referensi.

Penerapan

Add(TKey, TValue)

Pengecualian

ArgumentNullException

keyadalah null.

ArgumentException

Elemen dengan kunci yang sama sudah ada di SortedDictionary<TKey,TValue>.

Contoh

Contoh kode berikut membuat string kosong SortedDictionary<TKey,TValue> dengan kunci string dan menggunakan Add metode untuk menambahkan beberapa elemen. Contoh menunjukkan bahwa Add metode melemparkan ArgumentException saat mencoba menambahkan kunci duplikat.

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk SortedDictionary<TKey,TValue> kelas .

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

Keterangan

Anda juga dapat menggunakan Item[] properti untuk menambahkan elemen baru dengan mengatur nilai kunci yang tidak ada di SortedDictionary<TKey,TValue>; misalnya, myCollection["myNonexistentKey"] = myValue (di Visual Basic, myCollection("myNonexistantKey") = myValue). Namun, jika kunci yang ditentukan sudah ada di SortedDictionary<TKey,TValue>, pengaturan Item[] properti akan menimpa nilai lama. Sebaliknya, Add metode ini memberikan pengecualian jika elemen dengan kunci yang ditentukan sudah ada.

Kunci tidak boleh null, tetapi nilainya bisa, jika jenis TValue nilai adalah jenis referensi.

Metode ini adalah operasi O(log n), di mana n adalah Count.

Lihat juga

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