Stack<T>.TrimExcess Metodo

Definizione

Overload

TrimExcess()

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

TrimExcess(Int32)

Imposta la capacità di un oggetto Stack<T> su un numero specificato di voci.

TrimExcess()

Origine:
Stack.cs
Origine:
Stack.cs
Origine:
Stack.cs

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

public void 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 Stack<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 Stack<T>, chiamare il metodo Clear prima di chiamare TrimExcess metodo. Tagliare un Stack<T> vuoto imposta la capacità del Stack<T> sulla capacità predefinita.

Vedi anche

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

TrimExcess(Int32)

Origine:
Stack.cs

Imposta la capacità di un oggetto Stack<T> su un numero specificato di voci.

public void TrimExcess (int capacity);

Parametri

capacity
Int32

Nuova capacità.

Eccezioni

La capacità passata è inferiore a 0 o numero di voci.

Si applica a

.NET 9
Prodotto Versioni
.NET 9