Stack<T>.TrimExcess Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
TrimExcess() |
Define a capacidade para o número real de elementos no Stack<T>, se esse número for menor que 90% da capacidade atual. |
TrimExcess(Int32) |
Define a capacidade de um objeto Stack<T> para um número especificado de entradas. |
TrimExcess()
- 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 menor que 90% da capacidade atual.
public:
void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()
Comentários
Esse método pode ser usado para minimizar a sobrecarga de memória de uma coleção se nenhum elemento novo for adicionado à coleção. No entanto, o custo de realocar e copiar um grande Stack<T> pode ser considerável, portanto, o método TrimExcess não fará nada se a lista estiver em mais de 90% da capacidade. Isso evita incorrer em um grande custo de realocação para um ganho relativamente pequeno.
Esse método é uma operação O(n
), em que n
é Count.
Para redefinir um Stack<T> para seu estado inicial, chame o método Clear antes de chamar TrimExcess método. Cortar um Stack<T> vazio define a capacidade do Stack<T> como a capacidade padrão.
Confira também
Aplica-se a
TrimExcess(Int32)
- Origem:
- Stack.cs
Define a capacidade de um objeto Stack<T> 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
A capacidade passada é inferior a 0 ou a contagem de entradas.