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 設定することもできます。

適用対象

こちらもご覧ください