Queue<T>.TrimExcess Метод

  • Ссылка

Определение

Пространство имен:
System.Collections.Generic
Сборка:
System.Collections.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Перегрузки

TrimExcess()

Задает емкость фактическому количеству элементов в Queue<T>, если это число меньше 90 процентов текущей емкости.
TrimExcess(Int32)

Задает емкость объекта Queue<T> заданному количеству записей.

TrimExcess()

Исходный код:
Queue.cs
Исходный код:
Queue.cs
Исходный код:
Queue.cs

Задает емкость фактическому количеству элементов в Queue<T>, если это число меньше 90 процентов текущей емкости.

public:
 void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()

Комментарии

Этот метод можно использовать для минимизации затрат на память коллекции, если новые элементы не будут добавлены в коллекцию. Стоимость перераспределения и копирования большого Queue<T> может быть значительной, поэтому метод TrimExcess ничего не делает, если список составляет более 90 процентов емкости. Это позволяет избежать больших затрат на перемещение относительно небольшого прироста.

Этот метод является операцией O(n) , где nCount.

Чтобы сбросить Queue<T> в исходное состояние, вызовите метод Clear перед вызовом метода TrimExcess. Обрезание пустой Queue<T> задает емкость Queue<T> емкостью по умолчанию.

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

Применяется к

TrimExcess(Int32)

Исходный код:
Queue.cs

Задает емкость объекта Queue<T> заданному количеству записей.

public:
 void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

Параметры

capacity
Int32

Новая емкость.

Исключения

ArgumentOutOfRangeException

Переданная емкость меньше количества записей.

Применяется к