OrderedDictionary.Insert(Int32, Object, Object) Yöntem

Tanım

Ad Alanı:

System.Collections.Specialized

Bütünleştirilmiş Kod:

System.Collections.Specialized.dll

Kaynak:

OrderedDictionary.cs

Belirtilen dizinde OrderedDictionary belirtilen anahtar ve değerle koleksiyona yeni bir giriş ekler.

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)

Parametreler

index

Int32

Öğenin eklenmesi gereken sıfır tabanlı dizin.

key

Object

Eklenecek girişin anahtarı.

value

Object

Eklenecek girdinin değeri. Değer olabilir null.

Uygulamalar

Insert(Int32, Object, Object)

Özel durumlar

ArgumentOutOfRangeException

index aralığın dışında.

NotSupportedException

Bu koleksiyon salt okunurdur.

Örnekler

Aşağıdaki kod örneği, bir OrderedDictionary koleksiyonun değiştirilmesini gösterir. Bu örnekte yöntemi, öğesinin Insert başına OrderedDictionaryyeni bir giriş eklemek ve kalan girişleri aşağı taşımak için kullanılır. Bu kod, adresinde OrderedDictionarygörüntülenebilen daha büyük bir kod örneğinin parçasıdır.

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

Açıklamalar

index parametresi koleksiyondaki OrderedDictionary girdi sayısına eşitse ve keyvalue parametreleri koleksiyonun sonuna eklenir.

Ekleme noktasını izleyen girişler, yeni girdiye uyum sağlamak için aşağı taşınır ve taşınan girdilerin dizinleri de güncelleştirilir.