Stack<T>.TrimExcess Metodo

Definizione

Spazio dei nomi:
System.Collections.Generic
Assembly:
System.dll, System.Collections.dll
Assembly:
netstandard.dll, System.Collections.dll
Assembly:
System.Collections.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Overload

Nome Descrizione
TrimExcess()

Imposta la capacità sul numero effettivo di elementi in Stack<T>, se tale numero è minore del 90% della capacità corrente.
TrimExcess(Int32)

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

TrimExcess()

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

Imposta la capacità sul numero effettivo di elementi in Stack<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 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 oggettoStack<T>, chiamare il metodo prima di chiamare Clear il TrimExcess metodo . Il taglio di un oggetto vuoto Stack<T> imposta la capacità dell'oggetto Stack<T> sulla capacità predefinita.

Vedi anche

Si applica a

TrimExcess(Int32)

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

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

public:
 void TrimExcess(int capacity);
public void TrimExcess(int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

Parametri

capacity
Int32

Nuova capacità.

Eccezioni

ArgumentOutOfRangeException

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

Si applica a