Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SortedList<TKey, TValue>.Add-Methode: (TKey, TValue)

 

Veröffentlicht: Oktober 2016

Fügt dem SortedList<TKey, TValue> ein Element mit dem angegebenen Schlüssel und Wert hinzu.

Namespace:   System.Collections.Generic
Assembly:  System (in System.dll)

public void Add(
	TKey key,
	TValue value
)

Parameter

key
Type: TKey

Der Schlüssel des hinzuzufügenden Elements.

value
Type: TValue

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

Exception Condition
ArgumentNullException

key ist null.

ArgumentException

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

Ein Schlüssel kann nicht null, jedoch kann ein Wert, wenn der Typ der Werte in der sortierten Liste, TValue, ein Verweistyp ist.

Können Sie auch die Item Eigenschaft neue Elemente hinzufügen, indem Sie den Wert eines Schlüssels festlegen, ist nicht vorhanden, der SortedList<TKey, TValue>z. B. myCollection["myNonexistentKey"] = myValue. Jedoch, wenn der angegebene Schlüssel in bereits der SortedList<TKey, TValue>, wird durch das Festlegen der Item -Eigenschaft überschreibt den alten Wert. Im Gegensatz dazu die Add Methode vorhandene Elemente nicht geändert.

Wenn Count bereits gleich Capacity, wird die Kapazität der SortedList<TKey, TValue> wird von automatisch erneut zugewiesen werden, die internen Arrays erhöht und die vorhandenen Elemente werden in das neue Array kopiert, bevor das neue Element hinzugefügt wird.

Diese Methode ist eine O (n) Vorgang für unsortierte Daten, wobei n ist Count. Es ist ein O(log n)-Vorgang, wenn das neue Element am Ende der Liste hinzugefügt wird. Wenn die Einfügung eine Größe geändert werden muss, ist der Vorgang O (n).

Das folgende Codebeispiel erstellt ein leeres SortedList<TKey, TValue> von Zeichenfolgen mit Zeichenfolgenschlüsseln und verwendet die Add Methode, um einige Elemente hinzuzufügen. Im Beispiel wird veranschaulicht, dass die Add -Methode löst eine ArgumentException beim Versuch, einen doppelten Schlüssel hinzuzufügen.

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die SortedList<TKey, TValue> Klasse.

// 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.");
}

Universelle Windows-Plattform
Verfügbar seit 10
.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: