Hashtable.Item[Object] プロパティ

定義

名前空間:

System.Collections

アセンブリ:

System.Runtime.dll

ソース:

Hashtable.cs

指定されたキーに関連付けられている値を取得または設定します。

C#

public virtual object? this[object key] { get; set; }

パラメーター

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するには、 メソッドまたは メソッドをContainsKey使用してContains、キーがリストに存在するかどうかを確認します。

このプロパティの値の取得は操作です O(1) 。プロパティの設定も操作です O(1) 。

C# 言語では、this プロパティを実装する代わりに、Item[] キーワードを使用してインデクサーを定義します。 Visual Basic は、Item[] を既定のプロパティとして実装しており、同様のインデックス機能を提供します。

適用対象

こちらもご覧ください

• Add(Object, Object)