Queue<T>.TrimExcess Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.