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, set
Default Public Overridable Property Item(key As Object) As Object
參數
- key
- Object
與要取得或設定的值相關聯的索引鍵。
屬性值
如果找到 key
,則為與 SortedList 物件中 key
參數相關聯的值,否則為 null
。
實作
例外狀況
key
為 null
。
沒有足夠的記憶體可用,無法將元素加入至 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)
作業,其中 n
是 Count 。 如果索引鍵已經在 中 SortedList ,則設定 屬性是 O(log n)
作業。 如果索引鍵不在清單中,則設定 屬性是 O(n)
未排序資料的作業,或 O(log n)
新元素是在清單結尾加入時。 如果插入會導致調整大小,則作業為 O(n)
。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應