共用方式為


SortedList.Item[Object] 屬性

定義

取得或設定與 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, set
Default Public Overridable Property Item(key As Object) As Object

參數

key
Object

與要取得或設定的值相關聯的索引鍵。

屬性值

如果找到 key,則為與 SortedList 物件中 key 參數相關聯的值,否則為 null

實作

例外狀況

keynull

已設定該屬性,SortedList 物件為唯讀。

-或-

屬性已設定、key 不在於集合中,而且 SortedList 的大小固定。

沒有足夠的記憶體可用,無法將元素加入至 SortedList

比較子會擲回例外狀況。

備註

您可以藉由指定下列語法,使用 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) ,其中 nCount。 如果索引鍵已在 中SortedList,則設定屬性為O(log n)作業。 如果索引鍵不在清單中,則設定 屬性是 O(n) 未排序數據的作業,或 O(log n) 新元素是在清單結尾加入時。 如果插入會導致重設大小,作業會是 O(n)

適用於

另請參閱