SortedList.Item[Object] プロパティ

定義

名前空間:

System.Collections

アセンブリ:

System.Collections.NonGeneric.dll

ソース:

SortedList.cs

SortedList オブジェクト内の特定のキーに関連付けられている値を取得または設定します。

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; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

パラメーター

key

Object

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

プロパティ値

Object

key が存在する場合は、SortedList オブジェクト内の key パラメーターに関連付けられている値。それ以外の場合は null。

実装

Item[Object]

例外

ArgumentNullException

key が nullです。

NotSupportedException

このプロパティが設定されていますが、SortedList オブジェクトが読み取り専用です。

- または -

プロパティが設定済みで、コレクション内に key が存在せず、SortedList が固定サイズです。

OutOfMemoryException

メモリが不足しているため、SortedList に要素を追加できません。

InvalidOperationException

比較子が例外をスローしました。

注釈

プロパティをItem[]使用すると、次の構文を指定することで、コレクション内の特定の要素にアクセスできます。 myCollection[key]

このプロパティを使用して、オブジェクトに存在しないキーの値を設定して新しい要素を SortedList 追加することもできます (例: myCollection["myNonexistentKey"] = myValue))。 ただし、指定したキーが に既に SortedList存在する場合は、 プロパティを Item[] 設定すると古い値が上書きされます。 これに対し、 メソッドは既存の Add 要素を変更しません。

キーを に nullすることはできませんが、値は にできます。 指定したキーが見つかnullらず、指定したキーのnull値が であるために返されるのを区別nullするには、 メソッドまたは メソッドをContainsContainsKey使用して、キーが一覧に存在するかどうかを確認します。

の SortedList 要素は、 の作成時に指定された特定 IComparer の実装に従って、またはキー自体によって提供される SortedList 実装に IComparable 従って、キーによって並べ替えられます。

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

このプロパティの値の取得は操作です O(log n) 。ここで n 、 は Countです。 キーが に既SortedListにO(log n)存在する場合、プロパティの設定は操作です。 キーがリストにない場合、プロパティの設定は O(n) 、並べ替えられていないデータに対する操作、または O(log n) リストの末尾に新しい要素が追加された場合です。 挿入によってサイズが変更される場合、操作は です O(n)。

こちらもご覧ください

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• カルチャを認識しないコレクションの操作の実行