OrderedDictionary.Insert(Int32, Object, Object) メソッド

定義

名前空間:

System.Collections.Specialized

アセンブリ:

System.Collections.Specialized.dll

ソース:

OrderedDictionary.cs

OrderedDictionary コレクションの指定したインデックス位置に、指定したキーと値を持つ新しいエントリを挿入します。

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)

パラメーター

index

Int32

要素 を挿入する位置の、0 から始まるインデックス番号。

key

Object

追加するエントリのキー。

value

Object

追加するエントリの値。 値として null を指定できます。

実装

Insert(Int32, Object, Object)

例外

ArgumentOutOfRangeException

index が範囲外です。

NotSupportedException

このコレクションは読み取り専用です。

例

次のコード例は、コレクションの変更を OrderedDictionary 示しています。 この例では、 メソッドを Insert 使用して、 の先頭 OrderedDictionaryに新しいエントリを追加し、残りのエントリを下に移動します。 このコードは、 で表示できるより大きなコード例の 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

注釈

パラメーターが index コレクション内 OrderedDictionary のエントリ数と等しい場合、 key パラメーターと value パラメーターはコレクションの末尾に追加されます。

挿入ポイントに続くエントリは、新しいエントリに対応するために下に移動し、移動されたエントリのインデックスも更新されます。