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傳回，請使用 Contains 方法或 ContainsKey 方法來判斷索引鍵是否存在於清單中。

的專案SortedList會根據建立 時SortedList所指定的特定實作，或根據IComparable索引鍵本身提供的實作，依索引鍵本身所指定的特定IComparer實作來排序。

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)
• 在集合中執行 Culture-Insensitive 字串作業