SortedList<TKey,TValue>.Capacity プロパティ

定義

SortedList<TKey,TValue> に格納できる要素の数を取得または設定します。Gets or sets the number of elements that the SortedList<TKey,TValue> can contain.

public:
 property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
member this.Capacity : int with get, set
Public Property Capacity As Integer

プロパティ値

SortedList<TKey,TValue> に格納できる要素の数。The number of elements that the SortedList<TKey,TValue> can contain.

例外

CapacityCount より小さい値に設定されます。Capacity is set to a value that is less than Count.

システムで使用可能なメモリが不足しています。There is not enough memory available on the system.

注釈

CapacitySortedList<TKey,TValue>格納できる要素の数を指定します。Capacity is the number of elements that the SortedList<TKey,TValue> can store. Countは、 SortedList<TKey,TValue>実際に内にある要素の数です。Count is the number of elements that are actually in the SortedList<TKey,TValue>.

Capacityは、常にCount以上です。Capacity is always greater than or equal to Count. Count要素Capacityの追加中にを超えた場合、によって、古い要素をコピーして新しい要素を追加する前に、内部配列が自動的に再割り当てされ、容量が増加します。If Count exceeds Capacity while adding elements, the capacity is increased by automatically reallocating the internal array before copying the old elements and adding the new elements.

容量は、を呼び出すTrimExcessか、プロパティをCapacity明示的に設定することによって減らすことができます。The capacity can be decreased by calling TrimExcess or by setting the Capacity property explicitly. Capacity値が明示的に設定されている場合は、指定された容量に合わせて内部配列も再割り当てされます。When the value of Capacity is set explicitly, the internal array is also reallocated to accommodate the specified capacity.

このプロパティの値の取得は O (1) 操作です。プロパティを設定すると、On() 操作にnなります。ここで、は新しい容量です。Retrieving the value of this property is an O(1) operation; setting the property is an O(n) operation, where n is the new capacity.

適用対象

こちらもご覧ください