Compartilhar via


Queue<T>.TrimExcess Método

Definição

Sobrecargas

TrimExcess()

Define a capacidade para o número real de elementos no Queue<T>, se esse número for menor que 90% da capacidade atual.

TrimExcess(Int32)

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

TrimExcess()

Origem:
Queue.cs
Origem:
Queue.cs
Origem:
Queue.cs

Define a capacidade para o número real de elementos no Queue<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 Queue<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 Queue<T> para seu estado inicial, chame o método Clear antes de chamar TrimExcess método. Cortar um Queue<T> vazio define a capacidade do Queue<T> como a capacidade padrão.

Confira também

Aplica-se a

TrimExcess(Int32)

Origem:
Queue.cs

Define a capacidade de um objeto Queue<T> para o 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 é menor do que a contagem de entradas.

Aplica-se a