語言

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
來源:
Hashtable.cs
來源:
Hashtable.cs
來源:
Hashtable.cs
來源:
Hashtable.cs
來源:
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[] 預設屬性實作，提供相同的索引功能。

適用於

另請參閱