OrderedDictionary.Insert(Int32, Object, Object) Methode

Definitie

Naamruimte:
System.Collections.Specialized
Assembly's:
System.dll, System.Collections.Specialized.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Hiermee voegt u een nieuwe vermelding in de OrderedDictionary verzameling in met de opgegeven sleutel en waarde in de opgegeven index.

public:
 virtual void Insert(int index, System::Object ^ key, System::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)

Parameters

index
Int32

De op nul gebaseerde index waarop het element moet worden ingevoegd.

key
Object

De sleutel van de vermelding die moet worden toegevoegd.

value
Object

De waarde van de vermelding die moet worden toegevoegd. De waarde kan zijn null.

Implementeringen

Insert(Int32, Object, Object)

Uitzonderingen

ArgumentOutOfRangeException

index valt buiten het bereik.

NotSupportedException

Deze verzameling heeft het kenmerk Alleen-lezen.

Voorbeelden

In het volgende codevoorbeeld ziet u de wijziging van een OrderedDictionary verzameling. In dit voorbeeld wordt de Insert methode gebruikt om een nieuwe vermelding toe te voegen aan het begin van het OrderedDictionaryitem, waarbij de rest van de items omlaag worden verplaatst. Deze code maakt deel uit van een groter codevoorbeeld dat kan worden bekeken op OrderedDictionary.

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

Opmerkingen

Als de index parameter gelijk is aan het aantal vermeldingen in de OrderedDictionary verzameling, worden de key parameters value toegevoegd aan het einde van de verzameling.

Vermeldingen die de invoegpositie volgen, worden omlaag verplaatst om plaats te bieden aan de nieuwe vermelding en de indexen van de verplaatste items worden ook bijgewerkt.

Van toepassing op