Compartir a través de


Queue<T>.TrimExcess Método

Definición

Sobrecargas

TrimExcess()

Establece la capacidad en el número real de elementos de la Queue<T>, si ese número es menor que el 90 % de la capacidad actual.

TrimExcess(Int32)

Establece la capacidad de un objeto Queue<T> en el número especificado de entradas.

TrimExcess()

Source:
Queue.cs
Source:
Queue.cs
Source:
Queue.cs

Establece la capacidad en el número real de elementos de la Queue<T>, si ese número es menor que el 90 % de la capacidad actual.

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

Comentarios

Este método se puede usar para minimizar la sobrecarga de memoria de una colección si no se agregarán elementos nuevos a la colección. Sin embargo, el costo de reasignar y copiar un Queue<T> grande puede ser considerable, por lo que el método TrimExcess no hace nada si la lista tiene más del 90 % de capacidad. Esto evita incurrir en un gran costo de reasignación para una ganancia relativamente pequeña.

Este método es una operación de O(n), donde n es Count.

Para restablecer un Queue<T> a su estado inicial, llame al método Clear antes de llamar al método TrimExcess. El recorte de un Queue<T> vacío establece la capacidad del Queue<T> en la capacidad predeterminada.

Consulte también

Se aplica a

TrimExcess(Int32)

Source:
Queue.cs

Establece la capacidad de un objeto Queue<T> en el número especificado de entradas.

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

Parámetros

capacity
Int32

Nueva capacidad.

Excepciones

La capacidad superada es menor que el número de entradas.

Se aplica a