Hashtable.Item[Object] 属性

定义

命名空间:

System.Collections

程序集:

mscorlib.dll, System.Collections.NonGeneric.dll

程序集:

System.Runtime.dll

程序集:

System.Collections.NonGeneric.dll

程序集:

System.Runtime.Extensions.dll

程序集:

mscorlib.dll

程序集:

netstandard.dll

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

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; }

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]。

还可以通过设置不存在的Hashtable键的值来使用该Item[]属性添加新元素，例如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)