SortedList.Item[Object] プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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; }public virtual object? this[object key] { get; set; }member this.Item(obj) : obj with get, setDefault Public Overridable Property Item(key As Object) As Objectパラメーター
- key
- Object
取得または設定する値に関連付けられているキー。
プロパティ値
key が存在する場合は、SortedList オブジェクト内の key パラメーターに関連付けられている値。それ以外の場合は null。
実装
例外
key が nullです。
このプロパティが設定されていますが、SortedList オブジェクトが読み取り専用です。
- または -
プロパティが設定済みで、コレクション内に
keyが存在せず、SortedList が固定サイズです。
メモリが不足しているため、SortedList に要素を追加できません。
比較子が例外をスローしました。
注釈
このプロパティを Item[] 使用すると、次の構文 myCollection[key]を指定することで、コレクション内の特定の要素にアクセスできます。
このプロパティを使用して、オブジェクトに存在しないキーの値を設定することで、新しい要素を SortedList 追加することもできます (例: myCollection["myNonexistentKey"] = myValue). ただし、指定したキーが既に SortedList存在する場合は、プロパティを Item[] 設定すると古い値が上書きされます。 これに対し、メソッドは既存の要素を Add 変更しません。
キーを指定 nullすることはできませんが、値を指定することもできます。 指定したキーが見つからないために返されるキーとnull、指定したキーの値が指定されているために返されるキーを区別nullするには、メソッドまたはメソッドをContainsKey使用してContains、キーがnullリストに存在するかどうかを判断します。
a SortedList の要素は、作成時に指定されたSortedList特定IComparerの実装に従って、またはキー自体によって提供される実装にIComparable従って、キーによって並べ替えられます。
C# 言語では、このキーワードを this 使用して、プロパティを実装する代わりにインデクサーを Keys 定義します。 Visual Basic は、Item[] を既定のプロパティとして実装しており、同様のインデックス機能を提供します。
このプロパティの値を取得する O(log n) 操作は、次の操作 n です Count。 キーが既SortedListに O(log n) . キーがリストに含まれていない場合、プロパティの設定は O(n) 、並べ替えられていないデータに対する操作、または O(log n) リストの末尾に新しい要素が追加される場合です。 挿入によってサイズが変更された場合、操作は O(n).