Hashtable.Item[Object] 属性

定义

命名空间:
System.Collections
程序集:
mscorlib.dll, System.Collections.NonGeneric.dll
程序集:
netstandard.dll, System.Runtime.dll
程序集:
System.Collections.NonGeneric.dll
程序集:
System.Runtime.Extensions.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs
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; }
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[] 为默认属性，该属性提供相同的索引功能。

适用于

另请参阅