Queue<T>.TrimExcess Metodo

Definizione

Imposta la capacità sul numero effettivo di elementi contenuti nell'oggetto Queue<T>, se questo numero è inferiore al 90 per cento della capacità corrente.Sets the capacity to the actual number of elements in the Queue<T>, if that number is less than 90 percent of current capacity.

public:
 void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()

Commenti

Questo metodo può essere utilizzato per ridurre al minimo l'overhead della memoria di una raccolta se non vengono aggiunti nuovi elementi alla raccolta.This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. Tuttavia, il costo della riallocazione e della copia di grandi dimensioni Queue<T> può essere considerevole, pertanto il TrimExcess metodo non esegue alcuna operazione se l'elenco supera il 90% della capacità.The cost of reallocating and copying a large Queue<T> can be considerable, however, so the TrimExcess method does nothing if the list is at more than 90 percent of capacity. In questo modo si evita di incorrere in un costo di riallocazione elevato per un guadagno relativamente ridotto.This avoids incurring a large reallocation cost for a relatively small gain.

Questo metodo è un'operazione O ( n ), dove n è Count .This method is an O(n) operation, where n is Count.

Per reimpostare uno Queue<T> sullo stato iniziale, chiamare il Clear metodo prima di chiamare il TrimExcess metodo.To reset a Queue<T> to its initial state, call the Clear method before calling TrimExcess method. Il taglio di un oggetto vuoto Queue<T> imposta la capacità di sulla Queue<T> capacità predefinita.Trimming an empty Queue<T> sets the capacity of the Queue<T> to the default capacity.

Si applica a

Vedi anche