Hashtable.Item[Object] プロパティ

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

パラメーター

プロパティ値

指定されたキーに関連付けられている値。 指定したキーが見つからない場合、そのキーを取得しようとした場合は null が返され、そのキーを設定しようとした場合は、指定したキーを使用して新しい要素が作成されます。

実装

例外

注釈

このプロパティは、構文 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)