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

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 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:

Freigeben über