OrderedDictionary.Add(Object, Object) Methode

Referenz

Definition

Namespace:: System.Collections.Specialized

Assemblys:: System.dll, System.Collections.Specialized.dll

Assembly:: System.Collections.Specialized.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: OrderedDictionary.cs

Quelle:: OrderedDictionary.cs

Quelle:: OrderedDictionary.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der OrderedDictionary-Auflistung am kleinsten verfügbaren Index einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu.

public:
 virtual void Add(System::Object ^ key, System::Object ^ value);

public void Add (object key, object value);

public void Add (object key, object? value);

abstract member Add : obj * obj -> unit
override this.Add : obj * obj -> unit

Public Sub Add (key As Object, value As Object)

Parameter

key: Object

Der Schlüssel des hinzuzufügenden Eintrags.

value: Object

Der Wert des hinzuzufügenden Eintrags. Dieser Wert kann null sein.

Implementiert

Add(Object, Object)

Ausnahmen

NotSupportedException

Die OrderedDictionary-Auflistung ist schreibgeschützt.

ArgumentException

Ein Element mit demselben Schlüssel ist bereits in OrderedDictionary vorhanden.

Beispiele

Im folgenden Codebeispiel wird die Erstellung und Auffüllung einer OrderedDictionary Auflistung veranschaulicht. Dieser Code ist Teil eines größeren Codebeispiels, das unter OrderedDictionaryangezeigt werden kann.

// Creates and initializes a OrderedDictionary.
OrderedDictionary^ myOrderedDictionary = gcnew OrderedDictionary();
myOrderedDictionary->Add("testKey1", "testValue1");
myOrderedDictionary->Add("testKey2", "testValue2");
myOrderedDictionary->Add("keyToDelete", "valueToDelete");
myOrderedDictionary->Add("testKey3", "testValue3");

ICollection^ keyCollection = myOrderedDictionary->Keys;
ICollection^ valueCollection = myOrderedDictionary->Values;

// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary->Count);

// Creates and initializes a OrderedDictionary.
OrderedDictionary myOrderedDictionary = new OrderedDictionary();
myOrderedDictionary.Add("testKey1", "testValue1");
myOrderedDictionary.Add("testKey2", "testValue2");
myOrderedDictionary.Add("keyToDelete", "valueToDelete");
myOrderedDictionary.Add("testKey3", "testValue3");

ICollection keyCollection = myOrderedDictionary.Keys;
ICollection valueCollection = myOrderedDictionary.Values;

// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary.Count);

' Creates and initializes a OrderedDictionary.
Dim myOrderedDictionary As New OrderedDictionary()
myOrderedDictionary.Add("testKey1", "testValue1")
myOrderedDictionary.Add("testKey2", "testValue2")
myOrderedDictionary.Add("keyToDelete", "valueToDelete")
myOrderedDictionary.Add("testKey3", "testValue3")

Dim keyCollection As ICollection = myOrderedDictionary.Keys
Dim valueCollection As ICollection = myOrderedDictionary.Values

' Display the contents Imports the key and value collections
DisplayContents( _
    keyCollection, valueCollection, myOrderedDictionary.Count)

Hinweise

Ein Schlüssel kann nicht sein null, aber ein Wert kann sein.

Sie können die Item[] -Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der in der OrderedDictionary Auflistung nicht vorhanden ist. Wenn der angegebene Schlüssel jedoch bereits in OrderedDictionaryvorhanden ist, überschreibt die Item[] -Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add -Methode keine vorhandenen Elemente, sondern löst stattdessen aus ArgumentException.

Gilt für: