此主题尚未评级 - 评价此主题

IDictionary.Add 方法

2013/3/11

在 IDictionary 对象中添加一个带有所提供的键和值的元素。

Namespace:  System.Collections
程序集：  mscorlib（位于 mscorlib.dll 中）
C#
VB
复制 
void Add(
	Object key,
	Object value
)

参数

key
类型： System.Object
用作要添加的元素的键的 Object。
value
类型： System.Object
用作要添加的元素的值的 Object。
异常条件
ArgumentNullException

key 为 null。

ArgumentException

IDictionary 对象中已存在具有相同键的元素。

NotSupportedException

IDictionary 为只读。

- 或 -

IDictionary 具有固定大小。

通过设置字典中不存在的键值（例如，myCollection["myNonexistentKey"] = myValue），还可以使用 Item 属性添加新元素。但是，如果字典中已存在指定的键，则设置 Item 属性将覆盖旧值。相比之下，Add 方法不修改现有元素。

实现在是否允许键为 null 方面有所不同。

下面的代码示例演示如何实现 Add 方法。此代码示例是为 IDictionary 类提供的一个更大示例的一部分。

C#
VB
复制 

public void Add(object key, object value)
{
   // Add the new key/value pair even if this key already exists in the dictionary.
   if (ItemsInUse == items.Length)
      throw new InvalidOperationException("The dictionary cannot hold any more items.");
   items[ItemsInUse++] = new DictionaryEntry(key, value);
}

Windows Phone OS

受以下版本支持： 8.0, 7.1, 7.0

Windows Phone

本文是否对您有所帮助？
(1500 个剩余字符)
© 2013 Microsoft. 版权所有。