Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

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

 

Data di pubblicazione: ottobre 2016

Aggiunge la chiave e il valore specificati al dizionario.

Spazio dei nomi:   System.Collections.Generic
Assembly:  mscorlib (in mscorlib.dll)

public void Add(
	TKey key,
	TValue value
)

Parametri

key
Type: TKey

Chiave dell'elemento da aggiungere.

value
Type: TValue

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

Exception Condition
ArgumentNullException

key è null.

ArgumentException

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

You can also use the P:System.Collections.Generic.Dictionary`2.Item(`0) property to add new elements by setting the value of a key that does not exist in the T:System.Collections.Generic.Dictionary`2; for example, myCollection[myKey] = myValue (in Visual Basic, myCollection(myKey) = myValue). However, if the specified key already exists in the T:System.Collections.Generic.Dictionary`2, setting the P:System.Collections.Generic.Dictionary`2.Item(`0) property overwrites the old value. In contrast, the M:System.Collections.Generic.Dictionary`2.Add(`0,`1)method throws an exception if a value with the specified key already exists.

If the P:System.Collections.Generic.Dictionary`2.Count property value already equals the capacity, the capacity of the T:System.Collections.Generic.Dictionary`2 is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

A key cannot be null, but a value can be, if TValue is a reference type.

If P:System.Collections.Generic.Dictionary`2.Count is less than the capacity, this method approaches an O(1) operation. If the capacity must be increased to accommodate the new element, this method becomes an O(n) operation, where n is P:System.Collections.Generic.Dictionary`2.Count.

The following code example creates an empty T:System.Collections.Generic.Dictionary`2 of strings with string keys and uses the M:System.Collections.Generic.Dictionary`2.Add(`0,`1) method to add some elements. The example demonstrates that the M:System.Collections.Generic.Dictionary`2.Add(`0,`1) method throws an T:System.ArgumentException when attempting to add a duplicate key.

This code example is part of a larger example provided for the T:System.Collections.Generic.Dictionary`2 class.

// Create a new dictionary of strings, with string keys.
//
Dictionary<string, string> openWith = 
    new Dictionary<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.");
}

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 2.0
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: