OrderedDictionary.Insert(Int32, Object, Object) Methode

Definition

Namespace:
System.Collections.Specialized
Assemblys:
System.dll, System.Collections.Specialized.dll
Assemblys:
netstandard.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
Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs

Fügt einen neuen Eintrag in die OrderedDictionary Auflistung mit dem angegebenen Schlüssel und Wert am angegebenen Index ein.

public:
 virtual void Insert(int index, System::Object ^ key, System::Object ^ value);
public void Insert(int index, object key, object value);
public void Insert(int index, object key, object? value);
abstract member Insert : int * obj * obj -> unit
override this.Insert : int * obj * obj -> unit
Public Sub Insert (index As Integer, key As Object, value As Object)

Parameter

index
Int32

Der nullbasierte Index, an dem das Element eingefügt werden soll.

key
Object

Der Schlüssel des hinzuzufügenden Eintrags.

value
Object

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

Implementiert

Insert(Int32, Object, Object)

Ausnahmen

ArgumentOutOfRangeException

index liegt außerhalb des zulässigen Bereichs.

NotSupportedException

Diese Sammlung ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary Auflistung veranschaulicht. In diesem Beispiel wird die Insert Methode verwendet, um am Anfang des OrderedDictionaryEintrags einen neuen Eintrag hinzuzufügen, wobei die restlichen Einträge nach unten verschoben werden. Dieser Code ist Teil eines größeren Codebeispiels, das angezeigt OrderedDictionarywerden kann.

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}

' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then

    ' Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")

    ' Modify the value of the entry with the key "testKey2"
    myOrderedDictionary("testKey2") = "modifiedValue"

    ' Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)

    ' Remove the "keyToDelete" entry, if it exists
    If (myOrderedDictionary.Contains("keyToDelete")) Then
        myOrderedDictionary.Remove("keyToDelete")
    End If
End If

Hinweise

Wenn der index Parameter der Anzahl der Einträge in der OrderedDictionary Auflistung entspricht, werden die key Parameter am value Ende der Auflistung angefügt.

Einträge, die der Einfügemarke folgen, werden nach unten verschoben, um den neuen Eintrag aufzunehmen, und die Indizes der verschobenen Einträge werden ebenfalls aktualisiert.

Gilt für: