OrderedDictionary.Insert(Int32, Object, Object) Metode

Definisi

Ruang nama:

System.Collections.Specialized

Rakitan:

System.Collections.Specialized.dll

Sumber:

OrderedDictionary.cs

Menyisipkan entri baru ke OrderedDictionary dalam koleksi dengan kunci dan nilai yang ditentukan pada indeks yang ditentukan.

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)

Parameter

index

Int32

Indeks berbasis nol tempat elemen harus disisipkan.

key

Object

Kunci entri yang akan ditambahkan.

value

Object

Nilai entri yang akan ditambahkan. Nilainya bisa null.

Penerapan

Insert(Int32, Object, Object)

Pengecualian

ArgumentOutOfRangeException

index berada di luar jangkauan.

NotSupportedException

Koleksi ini bersifat baca-saja.

Contoh

Contoh kode berikut menunjukkan modifikasi OrderedDictionary koleksi. Dalam contoh ini, Insert metode digunakan untuk menambahkan entri baru ke awal OrderedDictionary, memindahkan sisa entri ke bawah. Kode ini adalah bagian dari contoh kode yang lebih besar yang dapat dilihat di 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

Keterangan

index Jika parameter sama dengan jumlah entri dalam OrderedDictionary koleksi, key parameter dan value ditambahkan ke akhir koleksi.

Entri yang mengikuti titik penyisipan bergerak ke bawah untuk mengakomodasi entri baru dan indeks entri yang dipindahkan juga diperbarui.