SortedList<TKey,TValue>.TrimExcess Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta la capacità sul numero effettivo di elementi contenuti nell'oggetto SortedList<TKey,TValue>, 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 il sovraccarico della memoria di una raccolta se non verranno aggiunti nuovi elementi alla raccolta. Il costo della riallocazione e della copia di un numero SortedList<TKey,TValue> elevato può tuttavia essere notevole, pertanto il metodo non fa nulla se l'elenco TrimExcess è a più del 90% della capacità. Ciò evita di sostenere un costo di reallocation elevato per un guadagno relativamente piccolo.
Questo metodo è un'operazione O(n
), dove n
è Count.
Per reimpostare lo SortedList<TKey,TValue> stato iniziale, chiamare il metodo prima di chiamare TrimExcess il Clear metodo. Il ritaglio di un vuoto SortedList<TKey,TValue> imposta la capacità dell'oggetto SortedList<TKey,TValue> sulla capacità predefinita.
La capacità può essere impostata anche usando la Capacity proprietà .