SortedList.Capacity 屬性

定義

命名空間:

System.Collections

組件:

System.Collections.NonGeneric.dll

來源:

SortedList.cs

取得或設定 SortedList 物件的容量。

public:
 virtual property int Capacity { int get(); void set(int value); };

public virtual int Capacity { get; set; }

member this.Capacity : int with get, set

Public Overridable Property Capacity As Integer

屬性值

Int32

SortedList 物件能夠包含的元素數目。

例外狀況

ArgumentOutOfRangeException

指派的值小於 SortedList 物件中目前的元素數目。

OutOfMemoryException

系統上沒有足夠的記憶體可用。

備註

Capacity 是物件可以儲存的項目 SortedList 數目。 Count 是實際在中的 SortedList項目數目。

Capacity 一律大於或等於 Count。 如果 Count 新增元素時超過 Capacity ，則會先重新配置內部數位，再複製舊元素並新增新元素，以自動增加容量。

您可以藉由呼叫 TrimToSize 或明確設定 Capacity 屬性來減少容量。 明確設定的值 Capacity 時，也會重新配置內部數位以容納指定的容量。

擷取此屬性的值是作業 O(1) ;設定屬性是 O(n) 作業，其中 n 是新的容量。

另請參閱

• TrimToSize()