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

定義

SortedList<TKey,TValue> 内にある実際の要素数が現在の容量の 90% 未満の場合は、容量をその数に設定します。

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

注釈

このメソッドを使用すると、コレクションに新しい要素が追加されない場合に、コレクションのメモリ オーバーヘッドを最小限に抑えることができます。 ただし、大規模 SortedList<TKey,TValue> な再割り当てとコピーのコストはかなりかかる可能性があるため TrimExcess 、リストが容量の 90% を超える場合、メソッドは何も行いません。 これにより、比較的小さなゲインに対して大きな再割り当てコストが発生するのを回避できます。

このメソッドは O(n) 操作です。nCount です。

初期状態にリセット SortedList<TKey,TValue> するには、メソッドを呼び出す前にメソッドを Clear 呼び出 TrimExcess します。 空 SortedList<TKey,TValue> をトリミングすると、その容量が SortedList<TKey,TValue> 既定の容量に設定されます。

このプロパティを使用して容量を Capacity 設定することもできます。

適用対象

こちらもご覧ください