Stack<T>.TrimExcess Metodo

Definizione

Spazio dei nomi:

System.Collections.Generic

Assembly:

System.Collections.dll

Overload

TrimExcess()

Imposta la capacità sul numero effettivo di elementi contenuti nell'oggetto Stack<T>, se questo numero è inferiore al 90 per cento della capacità corrente.

TrimExcess()

Source:

Stack.cs

Imposta la capacità sul numero effettivo di elementi contenuti nell'oggetto Stack<T>, se questo numero è inferiore al 90 per cento 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 l'overhead di memoria di una raccolta se non verranno aggiunti nuovi elementi alla raccolta. Il costo della riallocazione e della copia di un oggetto di grandi dimensioni Stack<T> può tuttavia essere notevole, pertanto il TrimExcess metodo 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), dove n è Count.

Per reimpostare lo stato iniziale di un Stack<T> oggetto , chiamare il metodo prima di chiamare TrimExcess il Clear metodo . Se si taglia un oggetto vuoto Stack<T> , la capacità di viene Stack<T> impostata sulla capacità predefinita.

Vedi anche

• Clear()
• Count