Hashtable.Item[Object] 属性

定义

命名空间:

System.Collections

程序集:

System.Runtime.dll

Source:

Hashtable.cs

获取或设置与指定的键关联的值。

public:
 virtual property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

public virtual object? this[object key] { get; set; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

参数

key

Object

要获取或设置其值的键。

属性值

Object

与指定的键相关联的值。 如果未找到指定的键，尝试获取它将返回 null，尝试设置它将使用指定的键创建新元素。

实现

Item[Object]

例外

ArgumentNullException

key 为 null。

NotSupportedException

设置了该属性，但 Hashtable 为只读。

- 或 -

设置了该属性，但 key 不存在于集合中，且 Hashtable 具有固定的大小。

注解

通过此属性，可以使用以下语法来访问集合中的特定元素：myCollection[key]。

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

键不能是 null，但值可以是 。 若要区分 null 由于未找到指定键而返回的 ，以及 null 由于指定键 null的值为 而返回的 ，请使用 Contains 方法或 ContainsKey 方法来确定列表中是否存在该键。

检索此属性的值是一个 O(1) 操作;设置属性也是一个 O(1) 操作。

C# 语言使用 this 关键字来定义索引器，而不是实现 Item[] 属性。 Visual Basic 将 Item[] 实现为默认属性，该属性提供相同的索引功能。

另请参阅

• Add(Object, Object)