OrderedDictionary.Insert(Int32, Object, Object) Metod

Definition

Namnområde:
System.Collections.Specialized
Sammansättningar:
System.dll, System.Collections.Specialized.dll
Sammansättningar:
netstandard.dll, System.Collections.Specialized.dll
Sammansättning:
System.Collections.Specialized.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll
Källa:
OrderedDictionary.cs
Källa:
OrderedDictionary.cs
Källa:
OrderedDictionary.cs
Källa:
OrderedDictionary.cs
Källa:
OrderedDictionary.cs

Infogar en ny post i OrderedDictionary samlingen med den angivna nyckeln och värdet vid det angivna indexet.

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)

Parametrar

index
Int32

Det nollbaserade index där elementet ska infogas.

key
Object

Nyckeln för posten som ska läggas till.

value
Object

Värdet för posten som ska läggas till. Värdet kan vara null.

Implementeringar

Insert(Int32, Object, Object)

Undantag

ArgumentOutOfRangeException

index är utom räckhåll.

NotSupportedException

Den här samlingen är skrivskyddad.

Exempel

Följande kodexempel visar hur en OrderedDictionary samling har ändrats. I det här exemplet Insert används metoden för att lägga till en ny post i början av OrderedDictionaryoch flytta resten av posterna nedåt. Den här koden är en del av ett större kodexempel som kan visas på 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

Kommentarer

Om parametern index är lika med antalet poster i OrderedDictionary samlingen läggs parametrarna key och value till i slutet av samlingen.

Poster som följer insättningspunkten flyttas nedåt för att anpassa den nya posten och indexen för de flyttade posterna uppdateras också.

Gäller för