(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

SortedList<TKey, TValue>.Add-Methode

Fügt der 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
Typ: TKey
Der Schlüssel des hinzuzufügenden Elements.
value
Typ: TValue
Der Wert des hinzuzufügenden Elements. Der Wert kann für Verweistypen null sein.

Implementiert

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

AusnahmeBedingung
ArgumentNullException

key ist null.

ArgumentException

Ein Element mit demselben Schlüssel ist bereits in SortedList<TKey, TValue> vorhanden.

Ein Schlüssel kann nicht null sein. Bei einem Wert ist dies hingegen zulässig, wenn der Typ der Werte in der sortierten Liste, TValue, ein Referenztyp ist.

Sie können auch die Item-Eigenschaft zum Hinzufügen neuer Elemente verwenden, indem Sie den Wert eines Schlüssels festlegen, der nicht in SortedList<TKey, TValue> vorhanden ist, z. B. myCollection["myNonexistentKey"] = myValue. Wenn der angegebene Schlüssel jedoch bereits im SortedList<TKey, TValue> vorhanden ist, wird der alte Wert beim Festlegen der Item-Eigenschaft überschrieben. Im Gegensatz dazu ändert die Add-Methode keine vorhandenen Elemente.

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

Diese Methode ist bei unsortierten Daten ein O(n)-Vorgang, wobei n für den Count steht. Wenn das neue Element am Ende der Liste hinzugefügt wird, handelt es sich um einen O(log n)-Vorgang. Wenn beim Einfügen die Größe geändert werden muss, handelt es sich um einen O (n)-Vorgang.

Im folgenden Codebeispiel wird ein leeres SortedList<TKey, TValue> von Zeichenfolgen mit Zeichenfolgenschlüsseln erstellt, und mithilfe der Add-Methode werden einige Elemente hinzugefügt. Im Beispiel wird veranschaulicht, dass die Add-Methode bei dem Versuch, einen doppelten Schlüssel hinzuzufügen, eine ArgumentException auslöst.

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


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


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft