Hashtable.Item 属性

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

**命名空间:**System.Collections
**程序集:**mscorlib（在 mscorlib.dll 中）

语法

声明
Public Overridable Default Property Item ( _
    key As Object _
) As Object
用法
Dim instance As Hashtable
Dim key As Object
Dim value As Object

value = instance(key)

instance(key) = value

public virtual Object this [
    Object key
] { get; set; }

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

/** @property */
public Object get_Item (Object key)

/** @property */
public void set_Item (Object key, Object value)

JScript 支持使用索引属性，但不支持进行新的声明。

参数

• key
  要获取或设置其值的键。

属性值

与指定的键相关联的值。如果未找到指定的键，尝试获取它将返回 空引用（在 Visual Basic 中为 Nothing），尝试设置它将使用指定的键创建新元素。

异常

异常类型	条件
ArgumentNullException	key 为 空引用（在 Visual Basic 中为 Nothing）。
NotSupportedException	设置该属性，而且 Hashtable 为只读。 - 或 - 设置该属性，集合中不存在 key，而且 Hashtable 具有固定大小。

备注

通过使用下面的语法，此属性提供访问集合中特定元素的能力：myCollection[key]。

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

键不能为 空引用（在 Visual Basic 中为 Nothing），但值可以。若要区分由于未找到指定键而返回的 空引用（在 Visual Basic 中为 Nothing） 和由于指定键的值为 空引用（在 Visual Basic 中为 Nothing） 而返回的 空引用（在 Visual Basic 中为 Nothing），请使用 Contains 方法或 ContainsKey 方法确定列表中是否存在该键。

检索此属性值的运算复杂度为 O(1)；设置此属性的运算复杂度也是 O(1)。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

Hashtable 类
Hashtable 成员
System.Collections 命名空间
Add