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

Definizione

Spazio dei nomi:

System.Collections.Generic

Assembly:

System.Collections.dll

Origine:

SortedDictionary.cs

Aggiunge un elemento con la chiave e il valore specificati al metodo 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)

Parametri

key

TKey

Chiave dell'elemento da aggiungere.

value

TValue

Valore dell'elemento da aggiungere. Il valore può essere null per i tipi di riferimento.

Implementazioni

Add(TKey, TValue)

Eccezioni

ArgumentNullException

key è null.

ArgumentException

In SortedDictionary<TKey,TValue> è già presente un elemento con la stessa chiave.

Esempio

Nell'esempio di codice seguente viene creato un vuoto SortedDictionary<TKey,TValue> di stringhe con chiavi stringa e viene usato il Add metodo per aggiungere alcuni elementi. Nell'esempio viene illustrato che il Add metodo genera un'eccezione ArgumentException quando si tenta di aggiungere una chiave duplicata.

Questo esempio di codice fa parte di un esempio più ampio fornito per la SortedDictionary<TKey,TValue> classe .

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

Commenti

È anche possibile utilizzare la Item[] proprietà per aggiungere nuovi elementi impostando il valore di una chiave che non esiste in SortedDictionary<TKey,TValue>; ad esempio, myCollection["myNonexistentKey"] = myValue in Visual Basic, myCollection("myNonexistantKey") = myValue. Tuttavia, se la chiave specificata esiste già in , l'impostazione SortedDictionary<TKey,TValue>della Item[] proprietà sovrascrive il valore precedente. Al contrario, il Add metodo genera un'eccezione se esiste già un elemento con la chiave specificata.

Una chiave non può essere null, ma un valore può essere, se il tipo di TValue valore è un tipo riferimento.

Questo metodo è un'operazione O(log n), dove n è Count.

Vedi anche

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