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()