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

Definition

Fügt dem Wörterbuch den angegebenen Schlüssel und Wert hinzu.

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

Der Schlüssel des hinzuzufügenden Elements.

value
TValue

Der Wert des hinzuzufügenden Elements. Der Wert kann für Verweistypen null sein.

Implementiert

Ausnahmen

key ist null.

In Dictionary<TKey,TValue> ist bereits ein Element mit demselben Schlüssel enthalten.

Beispiele

Im folgenden Codebeispiel wird eine leere Dictionary<TKey,TValue> Zeichenfolge mit Zeichenfolgenschlüsseln erstellt und die Methode verwendet Add , um einige Elemente hinzuzufügen. Im Beispiel wird veranschaulicht, dass die Add Methode beim ArgumentException Versuch, einen doppelten Schlüssel hinzuzufügen, ausgelöst wird.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Dictionary<TKey,TValue> Klasse bereitgestellt wird.

// Create a new dictionary of strings, with string keys.
//
Dictionary<String^, String^>^ openWith =
    gcnew 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.");
}
// 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.");
}
' Create a new dictionary of strings, with string keys.
'
Dim openWith As New Dictionary(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

Hinweise

Sie können auch die Item[] Eigenschaft verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der in der Dictionary<TKey,TValue>Datei nicht vorhanden ist; z myCollection[myKey] = myValue . B. (in Visual BasicmyCollection(myKey) = myValue). Wenn der angegebene Schlüssel jedoch bereits in der Dictionary<TKey,TValue>Eigenschaft vorhanden ist, überschreibt das Festlegen der Item[] Eigenschaft den alten Wert. Im Gegensatz dazu löst die Add Methode eine Ausnahme aus, wenn ein Wert mit dem angegebenen Schlüssel bereits vorhanden ist.

Wenn der Count Eigenschaftswert bereits die Kapazität entspricht, wird die Kapazität Dictionary<TKey,TValue> des Objekts erhöht, indem das interne Array automatisch neu zugewiesen wird, und die vorhandenen Elemente werden in das neue Array kopiert, bevor das neue Element hinzugefügt wird.

Ein Schlüssel kann nicht nullsein, aber ein Wert kann sein, wenn TValue es sich um einen Referenztyp handelt.

Ist Count die Kapazität kleiner als die Kapazität, geht diese Methode auf einen O(1)-Vorgang zu. Wenn die Kapazität erhöht werden muss, um das neue Element zu erfüllen, wird diese Methode zu einem O(n)-Vorgang.n Count

Gilt für:

Siehe auch