Queue<T>.TrimExcess Metodo

Definizione

Spazio dei nomi:

System.Collections.Generic

Assembly:

System.Collections.dll

Overload

TrimExcess()

Imposta la capacità sul numero effettivo di elementi nell'Queue<T>, se tale numero è minore del 90% della capacità corrente.

TrimExcess()

Origine:

Queue.cs

Imposta la capacità sul numero effettivo di elementi nell'Queue<T>, se tale numero è minore del 90% della capacità corrente.

public:
 void TrimExcess();

public void TrimExcess ();

member this.TrimExcess : unit -> unit

Public Sub TrimExcess ()

Commenti

Questo metodo può essere usato per ridurre al minimo il sovraccarico di memoria di una raccolta se non verranno aggiunti nuovi elementi alla raccolta. Il costo della riallocazione e della copia di un Queue<T> di grandi dimensioni può tuttavia essere notevole, quindi il metodo TrimExcess non esegue alcuna operazione se l'elenco è superiore al 90% della capacità. In questo modo si evita di sostenere un notevole costo di riallocazione per un guadagno relativamente ridotto.

Questo metodo è un'operazione O(n), in cui n è Count.

Per ripristinare lo stato iniziale di un Queue<T>, chiamare il metodo Clear prima di chiamare TrimExcess metodo. Tagliare un Queue<T> vuoto imposta la capacità del Queue<T> sulla capacità predefinita.

Vedi anche

• Clear()
• Count