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

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

SortedDictionary.cs

Fügt dem SortedDictionary<TKey,TValue> ein Element mit dem 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

Add(TKey, TValue)

Ausnahmen

ArgumentNullException

key ist null.

ArgumentException

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

Beispiele

Im folgenden Codebeispiel wird eine leere SortedDictionary<TKey,TValue> Zeichenfolge mit Zeichenfolgenschlüsseln erstellt und die Add -Methode verwendet, um einige Elemente hinzuzufügen. Das Beispiel zeigt, dass die Add -Methode eine ArgumentException auslöst, wenn versucht wird, einen doppelten Schlüssel hinzuzufügen.

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

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

Hinweise

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

Ein Schlüssel kann nicht sein null, aber ein Wert kann sein, wenn der Werttyp TValue ein Verweistyp ist.

Diese Methode ist ein O(log n) -Vorgang, wobei n ist Count.

Weitere Informationen

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