SortedList<TKey,TValue>.Add(TKey, TValue) SortedList<TKey,TValue>.Add(TKey, TValue) SortedList<TKey,TValue>.Add(TKey, TValue) SortedList<TKey,TValue>.Add(TKey, TValue) Method

Definition

Fügt dem SortedList<TKey,TValue> ein Element mit dem angegebenen Schlüssel und Wert hinzu.Adds an element with the specified key and value into the SortedList<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)

Parameter

key
TKey TKey TKey TKey

Der Schlüssel des hinzuzufügenden Elements.The key of the element to add.

value
TValue TValue TValue TValue

Der Wert des hinzuzufügenden Elements.The value of the element to add. Der Wert kann für Verweistypen null sein.The value can be null for reference types.

Implementiert

Ausnahmen

In SortedList<TKey,TValue> ist bereits ein Element mit demselben Schlüssel enthalten.An element with the same key already exists in the SortedList<TKey,TValue>.

Beispiele

Das folgende Codebeispiel erstellt ein leeres SortedList<TKey,TValue> von Zeichenfolgen mit Zeichenfolgenschlüsseln und verwendet die Add Methode, um einige Elemente hinzuzufügen.The following code example creates an empty SortedList<TKey,TValue> of strings with string keys and uses the Add method to add some elements. Im Beispiel wird veranschaulicht, die die Add -Methode löst eine ArgumentException beim Versuch, einen doppelten Schlüssel hinzuzufügen.The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die SortedList<TKey,TValue> Klasse.This code example is part of a larger example provided for the SortedList<TKey,TValue> class.

// Create a new sorted list of strings, with string
// keys.
SortedList<String^, String^>^ openWith =
    gcnew SortedList<String^, String^>();

// Add some elements to the list. 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 list.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}
// Create a new sorted list of strings, with string
// keys.
SortedList<string, string> openWith = 
    new SortedList<string, string>();

// Add some elements to the list. 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 list.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}
' Create a new sorted list of strings, with string 
' keys. 
Dim openWith As New SortedList(Of String, String)

' Add some elements to the list. 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 list.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Hinweise

Ein Schlüssel kann nicht null, jedoch kann ein Wert, wenn der Typ der Werte in der sortierten Liste TValue, ein Verweistyp ist.A key cannot be null, but a value can be, if the type of values in the sorted list, TValue, is a reference type.

Sie können auch die Item[TKey] zum Hinzufügen neuer Elemente durch Festlegen des Werts eines Schlüssels, die Eigenschaft ist nicht vorhanden, der SortedList<TKey,TValue>, z. B. myCollection["myNonexistentKey"] = myValueYou can also use the Item[TKey] property to add new elements by setting the value of a key that does not exist in the SortedList<TKey,TValue>; for example, myCollection["myNonexistentKey"] = myValue. Jedoch, wenn der angegebene Schlüssel bereits vorhanden ist die SortedList<TKey,TValue>wird durch das Festlegen der Item[TKey] Eigenschaft überschreibt den alten Wert.However, if the specified key already exists in the SortedList<TKey,TValue>, setting the Item[TKey] property overwrites the old value. Im Gegensatz dazu die Add Methode vorhandene Elemente nicht geändert.In contrast, the Add method does not modify existing elements.

Wenn Count bereits entspricht Capacity, wird die Kapazität von der SortedList<TKey,TValue> wird erhöht, die automatisch erneut zugewiesen werden, das interne Array, und die vorhandenen Elemente in das neue Array kopiert werden, bevor das neue Element hinzugefügt wird.If Count already equals Capacity, the capacity of the SortedList<TKey,TValue> is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

Diese Methode ist eine O (n) Vorgang für unsortierte Daten, wobei n ist Count.This method is an O(n) operation for unsorted data, where n is Count. Es ist eine O (Log n) Vorgang, wenn das neue Element am Ende der Liste hinzugefügt wird.It is an O(log n) operation if the new element is added at the end of the list. Einfügen einer Größenänderung verursacht, wird der Vorgang ist O (n).If insertion causes a resize, the operation is O(n).

Gilt für:

Siehe auch