OrderedDictionary.Insert(Int32, Object, Object) 方法

定义

命名空间:

System.Collections.Specialized

程序集:

System.Collections.Specialized.dll

Source:

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

应在从零开始的索引处插入元素。

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 参数追加到集合的末尾。

插入点后面的条目向下移动以适应新条目，移动条目的索引也会更新。