OrderedDictionary.Insert(Int32, Object, Object) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在指定索引处用指定键和值将新项插入到 OrderedDictionary 集合中。
public:
virtual void Insert(int index, System::Object ^ key, System::Object ^ value);public void Insert (int index, object key, object value);public void Insert (int index, object key, object? value);abstract member Insert : int * obj * obj -> unit
override this.Insert : int * obj * obj -> unitPublic Sub Insert (index As Integer, key As Object, value As Object)参数
- index
- Int32
应在从零开始的索引处插入元素。
- key
- Object
要添加的条目的键。
- value
- Object
要添加的条目的值。 该值可以为 null。
实现
例外
index 超出范围。
此集合为只读。
示例
下面的代码示例演示了对集合的 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 参数追加到集合的末尾。
插入点后面的条目向下移动以适应新条目，移动条目的索引也会更新。
