SortedList.Item[Object] プロパティ

定義

SortedList オブジェクト内の特定のキーに関連付けられている値を取得または設定します。Gets or sets the value associated with a specific key in a SortedList 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; }
member this.Item(obj) : obj with get, set
Default Public Overridable Property Item(key As Object) As Object

パラメーター

key
Object

取得または設定する値に関連付けられているキー。The key associated with the value to get or set.

プロパティ値

key が存在する場合は、SortedList オブジェクト内の key パラメーターに関連付けられている値。それ以外の場合は nullThe value associated with the key parameter in the SortedList object, if key is found; otherwise, null.

実装

例外

keynullです。key is null.

このプロパティが設定されていますが、SortedList オブジェクトが読み取り専用です。The property is set and the SortedList object is read-only.

- または --or- プロパティが設定済みで、コレクション内に key が存在せず、SortedList が固定サイズです。The property is set, key does not exist in the collection, and the SortedList has a fixed size.

メモリが不足しているため、SortedList に要素を追加できません。There is not enough available memory to add the element to the SortedList.

比較子が例外をスローしました。The comparer throws an exception.

注釈

Item[Object] プロパティを使用して、次の構文を指定することにより、コレクション内の特定の要素にアクセスできます: myCollection[key]You can use the Item[Object] property to access a specific element in a collection by specifying the following syntax: myCollection[key].

このプロパティを使用して、SortedList オブジェクトに存在しないキーの値 (myCollection["myNonexistentKey"] = myValue)など) を設定することによって、新しい要素を追加することもできます。You can also use this property to add new elements by setting the value of a key that does not exist in the SortedList object (for example, myCollection["myNonexistentKey"] = myValue). ただし、指定したキーが既に SortedListに存在する場合は、Item[Object] プロパティを設定すると古い値が上書きされます。However, if the specified key already exists in the SortedList, setting the Item[Object] property overwrites the old value. これに対し、Add メソッドでは、既存の要素は変更されません。In contrast, the Add method does not modify existing elements.

キーを nullすることはできませんが、値にはを指定できます。A key cannot be null, but a value can be. 指定されたキーが見つからなかったために返される null と、指定されたキーの値が nullために返される null を区別するには、Contains メソッドまたは ContainsKey メソッドを使用して、キーがリストに存在するかどうかを確認します。To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

SortedList の要素は、SortedList が作成されたとき、またはキー自体によって提供される IComparable の実装に従って指定された特定の IComparer 実装に従って、キーによって並べ替えられます。The elements of a SortedList are sorted by the keys either according to a specific IComparer implementation specified when the SortedList is created or according to the IComparable implementation provided by the keys themselves.

このC#言語では、Keys プロパティを実装する代わりに、 thisキーワードを使用してインデクサーを定義します。The C# language uses the this keyword to define the indexers instead of implementing the Keys property. Visual Basic は、Item[Object] を既定のプロパティとして実装しており、同様のインデックス機能を提供します。Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

このプロパティの値の取得は、nCountO(log n) 操作です。Retrieving the value of this property is an O(log n) operation, where n is Count. キーが既に SortedListに存在する場合、プロパティの設定は O(log n) 操作です。Setting the property is an O(log n) operation if the key is already in the SortedList. キーが一覧にない場合は、プロパティを設定すると、並べ替えられていないデータの O(n) 操作になります。または、新しい要素がリストの末尾に追加された場合は O(log n) ます。If the key is not in the list, setting the property is an O(n) operation for unsorted data, or O(log n) if the new element is added at the end of the list. 挿入によってサイズ変更が発生した場合、操作は O(n)されます。If insertion causes a resize, the operation is O(n).

適用対象

こちらもご覧ください