OrderedDictionary.Insert(Int32, 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

Fügt am angegebenen Index einen neuen Eintrag mit dem angegebenen Schlüssel und Wert in die OrderedDictionary-Auflistung 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 null sein.

Implementiert

Insert(Int32, Object, Object)

Ausnahmen

ArgumentOutOfRangeException

index liegt außerhalb des Bereichs.

NotSupportedException

Die Auflistung ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary Auflistung veranschaulicht. In diesem Beispiel wird die Insert -Methode verwendet, um einen neuen Eintrag am Anfang von OrderedDictionaryhinzuzufügen, wobei der Rest der Einträge nach unten verschoben wird. Dieser Code ist Teil eines größeren Codebeispiels, das unter OrderedDictionaryangezeigt werden 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 (!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 gleich der Anzahl der Einträge in der OrderedDictionary Auflistung ist, werden die key Parameter und value am 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: