Stack<T>.TrimExcess Método

Definição

Espaço de Nomes:
System.Collections.Generic
Assemblagens:
System.dll, System.Collections.dll
Assemblagens:
netstandard.dll, System.Collections.dll
Assemblagem:
System.Collections.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
TrimExcess()

Define a capacidade para o número real de elementos no Stack<T>, se esse número for inferior a 90 por cento da capacidade atual.
TrimExcess(Int32)

Define a capacidade de um Stack<T> objeto para um número especificado de entradas.

TrimExcess()

Origem:
Stack.cs
Origem:
Stack.cs
Origem:
Stack.cs
Origem:
Stack.cs
Origem:
Stack.cs

Define a capacidade para o número real de elementos no Stack<T>, se esse número for inferior a 90 por cento da capacidade atual.

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

Observações

Este método pode ser usado para minimizar a sobrecarga de memória de uma coleção caso não sejam adicionados novos elementos à coleção. No entanto, o custo de realocar e copiar um grande Stack<T> pode ser considerável, por isso o TrimExcess método não faz nada se a lista estiver a mais de 90 por cento da capacidade. Isto evita incorrer num custo elevado de realocação por um ganho relativamente pequeno.

Este método é uma operação O(n), onde n é Count.

Para reiniciar a Stack<T> ao seu estado inicial, chame o Clear método antes de chamar TrimExcess o método. Cortar um vazio Stack<T> define a capacidade do Stack<T> para a capacidade padrão.

Ver também

Aplica-se a

TrimExcess(Int32)

Origem:
Stack.cs
Origem:
Stack.cs
Origem:
Stack.cs

Define a capacidade de um Stack<T> objeto para um 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

A nova capacidade.

Exceções

ArgumentOutOfRangeException

A capacidade aprovada é inferior a 0 ou o número de inscrições.

Aplica-se a