Queue<T>.TrimExcess Method

Definition

Устанавливает емкость равной фактическому количеству элементов в Queue<T>, если это количество составляет менее 90 процентов текущей емкости.Sets the capacity to the actual number of elements in the Queue<T>, if that number is less than 90 percent of current capacity.

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

Remarks

Этот метод можно использовать для снижения нагрузки на память коллекции, если в коллекцию не добавляются новые элементы.This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. Однако стоимость повторного выделения и копирования больших Queue<T> может быть значительной, поэтому метод TrimExcess не выполняет никаких действий, если список имеет более 90 процентов емкости.The cost of reallocating and copying a large Queue<T> can be considerable, however, so the TrimExcess method does nothing if the list is at more than 90 percent of capacity. Это позволяет избежать больших затрат на повторное распределение для относительно небольшого выигрыша.This avoids incurring a large reallocation cost for a relatively small gain.

Этот метод является операцией O (n), где n Count.This method is an O(n) operation, where n is Count.

Чтобы сбросить Queue<T> до начального состояния, вызовите метод Clear перед вызовом метода TrimExcess.To reset a Queue<T> to its initial state, call the Clear method before calling TrimExcess method. Удаление пустой Queue<T> задает емкость объекта Queue<T> емкость по умолчанию.Trimming an empty Queue<T> sets the capacity of the Queue<T> to the default capacity.

Applies to

See also