Stack<T>.TrimExcess Método

Definición

Espacio de nombres:

System.Collections.Generic

Ensamblados:

netstandard.dll, System.Collections.dll

Sobrecargas

TrimExcess()	Establece la capacidad en el número real de elementos de la Stack<T>, si ese número es menor que el 90 % de la capacidad actual.
TrimExcess(Int32)	Establece la capacidad de un objeto Stack<T> en un número especificado de entradas.

TrimExcess()

Source:

Stack.cs

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

C#

public void 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 Stack<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 Stack<T> a su estado inicial, llame al método Clear antes de llamar al método TrimExcess. El recorte de un Stack<T> vacío establece la capacidad del Stack<T> en la capacidad predeterminada.

Consulte también

• Clear()
• Count

TrimExcess(Int32)

Source:

Stack.cs

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

C#

public void TrimExcess(int capacity);

Parámetros

capacity

Int32

Nueva capacidad.

Excepciones

ArgumentOutOfRangeException

La capacidad superada es inferior a 0 o recuento de entradas.