SortedList.Item プロパティ
SortedList 内の特定のキーに関連付けられている値を取得または設定します。
[C#] C# では、このプロパティは SortedList クラスのインデクサになります。
Public Overridable Default Property Item( _
ByVal key As Object _) As Object Implements IDictionary.Item
[C#]
public virtual object this[objectkey] {get; set;}
[C++]
public: __property virtual Object* get_Item(Object* key);public: __property virtual void set_Item(Object* key, Object*);
[JScript]
returnValue = SortedListObject.Item(key);SortedListObject.Item(key) = returnValue;またはreturnValue = SortedListObject(key);SortedListObject(key) = returnValue;
[JScript] JScript では、この型で定義されている既定のインデックス プロパティを使用することができます。しかし、独自のインデックス プロパティを明示的に定義することはできません。ただし、このクラスの expando 属性を指定すると、既定のインデックス プロパティが提供されます。提供されるインデックス プロパティの型は Object 型であり、インデックス型は String になります。
引数 [JScript]
- key
取得または設定する値に関連付けられているキー。
パラメータ [Visual Basic, C#, C++]
- key
取得または設定する値に関連付けられているキー。
プロパティ値
key が存在する場合は、 SortedList 内の key に関連付けられている値。それ以外の場合は null 参照 (Visual Basic では Nothing) 。
実装
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | key が null 参照 (Visual Basic では Nothing) です。 |
NotSupportedException | このプロパティが設定されていますが、 SortedList が読み取り専用です。
または このプロパティが設定されていますが、key がコレクション内に存在しません。また、 SortedList が固定サイズです。 |
InvalidOperationException | 比較演算子が例外をスローしました。 |
解説
このプロパティでは、 myCollection[key]
という構文を使用して、コレクション内の特定の要素にアクセスできます。
このプロパティを設定すると、指定したキーが SortedList に既に存在する場合は、その値が置換されます。それ以外の場合は、新しい要素が作成されます。対照的に、 Add メソッドは既存の要素を変更しません。
キーには null 参照 (Visual Basic では Nothing) は使用できませんが、値は null でもかまいません。指定したキーが存在しないために返される null 参照 (Nothing) と、指定したキーの値が null 参照 (Nothing) であるために返される null 参照 (Nothing) を区別するには、 Contains メソッドまたは ContainsKey メソッドを使用して、キーがリストに存在するかどうかを確認します。
SortedList の要素は、 SortedList が作成されるときに指定された IComparer の特定の実装か、キー自体が提供する IComparable 実装のいずれかに従って並べ替えられます。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
SortedList クラス | SortedList メンバ | System.Collections 名前空間 | Add | Contains | ContainsKey | カルチャを認識しないコレクションの操作の実行