Stack<T>.TrimExcess Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
TrimExcess() |
Задает емкость фактическому количеству элементов в Stack<T>, если это число меньше 90 процентов текущей емкости. |
TrimExcess(Int32) |
Задает емкость объекта Stack<T> заданному количеству записей. |
TrimExcess()
- Исходный код:
- Stack.cs
- Исходный код:
- Stack.cs
- Исходный код:
- Stack.cs
Задает емкость фактическому количеству элементов в Stack<T>, если это число меньше 90 процентов текущей емкости.
public:
void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()
Комментарии
Этот метод можно использовать для минимизации затрат на память коллекции, если новые элементы не будут добавлены в коллекцию. Стоимость перераспределения и копирования большого Stack<T> может быть значительной, поэтому метод TrimExcess ничего не делает, если список составляет более 90 процентов емкости. Это позволяет избежать больших затрат на перемещение относительно небольшого прироста.
Этот метод является операцией O(n
) , где n
Count.
Чтобы сбросить Stack<T> в исходное состояние, вызовите метод Clear перед вызовом метода TrimExcess. Обрезание пустой Stack<T> задает емкость Stack<T> емкостью по умолчанию.
См. также раздел
Применяется к
TrimExcess(Int32)
- Исходный код:
- Stack.cs
Задает емкость объекта Stack<T> заданному количеству записей.
public:
void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)
Параметры
- capacity
- Int32
Новая емкость.
Исключения
Переданная емкость меньше 0 или количество записей.