OrderedDictionary.Add(Object, Object) OrderedDictionary.Add(Object, Object) OrderedDictionary.Add(Object, Object) OrderedDictionary.Add(Object, Object) Method

Definition

Fügt der OrderedDictionary-Auflistung am kleinsten verfügbaren Index einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu.Adds an entry with the specified key and value into the OrderedDictionary collection with the lowest available index.

public:
 virtual void Add(System::Object ^ key, System::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 Object Object Object

Der Schlüssel des hinzuzufügenden Eintrags.The key of the entry to add.

value
Object Object Object Object

Der Wert des hinzuzufügenden Eintrags.The value of the entry to add. Dieser Wert kann null sein.This value can be null.

Implementiert

Ausnahmen

Ein Element mit demselben Schlüssel ist bereits in OrderedDictionary vorhanden.An element with the same key already exists in the OrderedDictionary collection.

Beispiele

Im folgenden Codebeispiel wird das Erstellen und Auffüllen einer OrderedDictionary -Auflistung veranschaulicht.The following code example demonstrates the creation and population of an OrderedDictionary collection. Dieser Code ist Teil eines größeren Code Beispiels, das unter OrderedDictionaryangezeigt werden kann.This code is part of a larger code example that can be viewed at OrderedDictionary.

// 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 nullsein, aber ein Wert kann sein.A key cannot be null, but a value can be.

Sie können Item[Object] auch die-Eigenschaft verwenden, um neue Elemente hinzuzufügen OrderedDictionary, indem Sie den Wert eines Schlüssels festlegen, der OrderedDictionary in der Auflistung nicht vorhanden ist. Wenn jedoch der angegebene Schlüssel bereits in vorhanden Item[Object] ist, wird durch das Festlegen der Eigenschaft überschrieben. der alte Wert.You can also use the Item[Object] property to add new elements by setting the value of a key that does not exist in the OrderedDictionary collection; however, if the specified key already exists in the OrderedDictionary, setting the Item[Object] property overwrites the old value. Im Gegensatz dazu ändert Add die-Methode vorhandene Elemente nicht, sondern löst ArgumentExceptionstattdessen aus.In contrast, the Add method does not modify existing elements but instead throws ArgumentException.

Gilt für: