SortedList<TKey,TValue>.TrimExcess Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает емкость равной фактическому количеству элементов в SortedList<TKey,TValue>, если это количество составляет менее 90 процентов текущей емкости.
public:
void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()
Комментарии
Этот метод можно использовать, чтобы свести к минимуму нагрузку на память коллекции, если в коллекцию не будут добавлены новые элементы. Однако затраты на перераспределение и копирование большого объекта SortedList<TKey,TValue> могут быть значительными, поэтому TrimExcess метод ничего не делает, если список находится на уровне более 90 процентов емкости. Это позволяет избежать больших затрат на перераспределение для относительно небольшой прибыли.
Этот метод является операцией O(n
), где n
— .Count
Чтобы сбросить объект в исходное SortedList<TKey,TValue> состояние, вызовите Clear метод перед вызовом TrimExcess метода . Удаление пустой SortedList<TKey,TValue> задает емкость объекта SortedList<TKey,TValue> емкость по умолчанию.
Емкость также можно задать с помощью Capacity свойства .