Queue<T>.TrimExcess Queue<T>.TrimExcess Queue<T>.TrimExcess Queue<T>.TrimExcess Method

Определение

Устанавливает емкость равной фактическому количеству элементов в 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 ()

Комментарии

Этот метод можно использовать для снижения нагрузки на память коллекции, если в коллекцию не добавляются новые элементы.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.

Этот метод является операцией On(), где 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.

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

Дополнительно