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

  • Referenz

Definition

Namespace:
System.Collections.Generic
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Fügt der IDictionary<TKey,TValue>-Schnittstelle ein Element mit dem angegebenen Schlüssel und Wert hinzu.

public:
 void Add(TKey key, TValue value);
public void Add (TKey key, TValue value);
abstract member Add : 'Key * 'Value -> unit
Public Sub Add (key As TKey, value As TValue)

Parameter

key
TKey

Das Objekt, das als Schlüssel des hinzuzufügenden Elements verwendet werden soll.

value
TValue

Das Objekt, das als Wert des hinzuzufügenden Elements verwendet werden soll.

Ausnahmen

ArgumentNullException

key ist null.

ArgumentException

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

NotSupportedException

IDictionary<TKey,TValue> ist schreibgeschützt.

Beispiele

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

Dieser Code ist Teil eines größeren Beispiels, das kompiliert und ausgeführt werden kann. Siehe System.Collections.Generic.IDictionary<TKey,TValue>.

// Create a new dictionary of strings, with string keys,
// and access it through the IDictionary generic interface.
IDictionary<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,
// and access it through the IDictionary generic interface.
IDictionary<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, 
' and access it through the IDictionary generic interface.
Dim openWith As IDictionary(Of String, String) = _
    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 die Item[] Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der im Wörterbuch nicht vorhanden ist, zmyCollection["myNonexistentKey"] = myValue. B. in C# (myCollection("myNonexistentKey") = myValue in Visual Basic). Wenn der angegebene Schlüssel jedoch bereits im Wörterbuch vorhanden ist, überschreibt das Festlegen der Item[] Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add Methode keine vorhandenen Elemente.

Implementierungen können variieren, wie sie die Gleichheit von Objekten bestimmen; Die Klasse verwendet Comparer<T>.Defaultz. BList<T>. die Klasse, während der Dictionary<TKey,TValue> Benutzer die Implementierung angeben kann, die IComparer<T> zum Vergleichen von Schlüsseln verwendet werden soll.

Implementierungen können variieren, ob sie zulassen key null.

Gilt für

Siehe auch