HashSet<T>.TrimExcess メソッド

定義

名前空間:

System.Collections.Generic

アセンブリ:

netstandard.dll, System.Collections.dll

オーバーロード

TrimExcess()	HashSet<T> オブジェクトの容量を、含まれる要素の実際の数に設定し、近くの実装固有の値に切り上げます。
TrimExcess(Int32)	HashSet<T> オブジェクトの容量を指定したエントリ数に設定し、近くの実装固有の値に切り上げます。

TrimExcess()

ソース:

HashSet.cs

HashSet<T> オブジェクトの容量を、含まれる要素の実際の数に設定し、近くの実装固有の値に切り上げます。

C#

public void TrimExcess();

例

次の例では、HashSet<T> コレクションを作成して設定し、コレクションをクリアして、そのコレクションによって参照されるメモリを解放します。

C#

HashSet<int> Numbers = new HashSet<int>();

for (int i = 0; i < 10; i++)
{
    Numbers.Add(i);
}

Console.Write("Numbers contains {0} elements: ", Numbers.Count);
DisplaySet(Numbers);

Numbers.Clear();
Numbers.TrimExcess();

Console.Write("Numbers contains {0} elements: ", Numbers.Count);
DisplaySet(Numbers);

void DisplaySet(HashSet<int> set)
{
    Console.Write("{");
    foreach (int i in set)
    {
        Console.Write(" {0}", i);
    }
    Console.WriteLine(" }");
}

/* This example produces output similar to the following:
* Numbers contains 10 elements: { 0 1 2 3 4 5 6 7 8 9 }
* Numbers contains 0 elements: { }
*/

注釈

TrimExcess メソッドを使用すると、新しい要素が追加されないことがわかっている場合に、HashSet<T> オブジェクトのメモリ オーバーヘッドを最小限に抑えることができます。 HashSet<T> オブジェクトを完全にクリアし、そのオブジェクトによって参照されているすべてのメモリを解放するには、Clear メソッドを呼び出した後、このメソッドを呼び出します。

このメソッドは O(n) 演算で、n が Count。

TrimExcess(Int32)

ソース:

HashSet.cs

HashSet<T> オブジェクトの容量を指定したエントリ数に設定し、近くの実装固有の値に切り上げます。

C#

public void TrimExcess(int capacity);

パラメーター

capacity

Int32

新しい容量。

例外

ArgumentOutOfRangeException

指定された容量は、エントリの数よりも少なくなります。