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[] を既定のプロパティとして実装します。このプロパティは、同じインデックス作成機能を提供します。

適用対象

こちらもご覧ください