SortedList<TKey,TValue>.Capacity Свойство

Определение

Пространство имен:

System.Collections.Generic

Сборка:

System.Collections.dll

Исходный код:

SortedList.cs

Возвращает или задает число элементов, которое может содержать список SortedList<TKey,TValue>.

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

Значение свойства

Int32

Количество элементов, которое может содержать коллекция SortedList<TKey,TValue>.

Исключения

ArgumentOutOfRangeException

Для Capacity установлено значение, которое меньше Count.

OutOfMemoryException

Не хватает памяти в системе.

Комментарии

Capacity — это количество элементов, которые может хранить объект SortedList<TKey,TValue> . Count — это количество элементов, которые фактически находятся в SortedList<TKey,TValue>.

Capacity значение всегда больше или равно Count. При Count превышении при добавлении Capacity элементов емкость увеличивается путем автоматического перераспределения внутреннего массива перед копированием старых элементов и добавлением новых элементов.

Емкость можно уменьшить путем вызова TrimExcess или явного Capacity задания свойства. Если значение задано явным образом, внутренний массив также перераспределяется для удовлетворения Capacity указанной емкости.

Получение значения этого свойства является операцией O(1); Задание свойства является операцией O(n), где n — это новая емкость.

См. также раздел

• Count
• TrimExcess()