SortedList<TKey,TValue>.TrimExcess メソッド


SortedList<TKey,TValue> 内にある実際の要素数が現在の容量の 90% 未満の場合は、容量をその数に設定します。Sets the capacity to the actual number of elements in the SortedList<TKey,TValue>, if that number is less than 90 percent of current capacity.

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


コレクションに新しい要素が追加されない場合は、このメソッドを使用してコレクションのメモリオーバーヘッドを最小限に抑えることができます。This method can be used to minimize a collection's memory overhead if no new elements will be added to the collection. ただし、大規模なの再割り当てSortedList<TKey,TValue>とコピーにかかるコストはかなり大きくTrimExcessなる可能性があるため、この方法では、リストの容量が 90% を超える場合は何も行われません。The cost of reallocating and copying a large SortedList<TKey,TValue> can be considerable, however, so the TrimExcess method does nothing if the list is at more than 90 percent of capacity. これにより、比較的小さな増加に対して大きな再割り当てコストが発生することを回避できます。This avoids incurring a large reallocation cost for a relatively small gain.

このメソッドは O(n) 操作です。nCount です。This method is an O(n) operation, where n is Count.

SortedList<TKey,TValue>初期状態にリセットするには、 TrimExcessメソッドClearを呼び出す前にメソッドを呼び出します。To reset a SortedList<TKey,TValue> to its initial state, call the Clear method before calling TrimExcess method. SortedList<TKey,TValue>のをトリミングすると、 SortedList<TKey,TValue>の容量が既定の容量に設定されます。Trimming an empty SortedList<TKey,TValue> sets the capacity of the SortedList<TKey,TValue> to the default capacity.

容量は、 Capacityプロパティを使用して設定することもできます。The capacity can also be set using the Capacity property.