Queue<T>.TrimExcess Metodo

Definizione

Overload

TrimExcess()

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

TrimExcess(Int32)

Imposta la capacità di un oggetto Queue<T> sul numero specificato di voci.

TrimExcess()

Origine:
Queue.cs
Origine:
Queue.cs
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

Si applica a

TrimExcess(Int32)

Origine:
Queue.cs

Imposta la capacità di un oggetto Queue<T> sul 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

La capacità passata è inferiore al numero di voci.

Si applica a