HashSet<T>.TrimExcess HashSet<T>.TrimExcess HashSet<T>.TrimExcess HashSet<T>.TrimExcess Method

Определение

Задает емкость объекта HashSet<T> равной фактическому числу элементов, которые в нем содержатся, округленному в большую сторону ближайшего значения, зависящего от реализации.Sets the capacity of a HashSet<T> object to the actual number of elements it contains, rounded up to a nearby, implementation-specific value.

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

Примеры

В следующем примере создается и заполняется HashSet<T> коллекция, а затем производится очистка коллекции и освобождается память, на которую ссылается объект.The following example creates and populates a HashSet<T> collection, and then clears the collection and releases the memory referenced by it.

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: { }
*/
Shared Sub Main()

    Dim Numbers As HashSet(Of Integer) = New HashSet(Of Integer)()

    For i As Integer = 0 To 9
        Numbers.Add(i)
    Next 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)

End Sub
' This code 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> память объекта после того, как известно, что новые элементы не добавляются.You can use the TrimExcess method to minimize a HashSet<T> object's memory overhead once it is known that no new elements will be added. Чтобы полностью очистить HashSet<T> объект и освободить всю память, вызовите этот метод после Clear вызова метода.To completely clear a HashSet<T> object and release all memory referenced by it, call this method after calling the Clear method.

Этот метод является операцией On(), где n имеет Count.This method is an O(n) operation, where n is Count.

Применяется к