OrderedDictionary.Insert(Int32, Object, Object) Metoda

Definice

Obor názvů:

System.Collections.Specialized

Sestavení:

System.Collections.Specialized.dll

Zdroj:

OrderedDictionary.cs

Vloží novou položku do OrderedDictionary kolekce se zadaným klíčem a hodnotou v zadaném indexu.

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)

Parametry

index

Int32

Index založený na nule, do kterého má být prvek vložen.

key

Object

Klíč položky, která se má přidat.

value

Object

Hodnota položky, která se má přidat. Hodnota může být null.

Implementuje

Insert(Int32, Object, Object)

Výjimky

ArgumentOutOfRangeException

index je mimo rozsah.

NotSupportedException

Tato kolekce je jen pro čtení.

Příklady

Následující příklad kódu ukazuje úpravu OrderedDictionary kolekce. V tomto příkladu Insert se metoda používá k přidání nové položky na začátek objektu OrderedDictionarya přesune zbývající položky dolů. Tento kód je součástí většího příkladu kódu, který lze zobrazit na adrese 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 (!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

Poznámky

Pokud se index parametr rovná počtu položek v kolekci OrderedDictionary , key připojí se parametry a value na konec kolekce.

Položky, které následují za místem vložení, se přesunou dolů, aby se přizpůsobily nové položce, a indexy přesunutých položek se také aktualizují.