HashSet<T>.TrimExcess Método

  • Referência

Definição

Namespace:
System.Collections.Generic
Assembly:
System.Collections.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Sobrecargas

TrimExcess()

Define a capacidade de um objeto HashSet<T> para o número real de elementos que ele contém, arredondado para um valor próximo e específico da implementação.
TrimExcess(Int32)

Define a capacidade de um objeto HashSet<T> para o número especificado de entradas, arredondado para um valor específico de implementação próximo.

TrimExcess()

Origem:
HashSet.cs
Origem:
HashSet.cs
Origem:
HashSet.cs

Define a capacidade de um objeto HashSet<T> para o número real de elementos que ele contém, arredondado para um valor próximo e específico da implementação.

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

Exemplos

O exemplo a seguir cria e popula uma coleção de HashSet<T> e limpa a coleção e libera a memória referenciada por ela.

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: { }
*/

let displaySet (set: HashSet<int>) =
    printf "{"

    for i in set do
        printf $" {i}"

    printfn " }"
// 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: { }
let numbers = HashSet<int>()

for i = 0 to 9 do
    numbers.Add i |> ignore

printf $"Numbers contains {numbers.Count} elements: "
displaySet numbers

numbers.Clear()
numbers.TrimExcess()

printf $"Numbers contains {numbers.Count} elements: "
displaySet numbers

Imports System.Collections.Generic

Class Program

    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: { }

    Private Shared Sub DisplaySet(ByVal coll As HashSet(Of Integer))
        Console.Write("{")
        For Each i As Integer In coll
            Console.Write(" {0}", i)
        Next i
        Console.WriteLine(" }")
    End Sub

End Class

Comentários

Você pode usar o método TrimExcess para minimizar a sobrecarga de memória de um objeto HashSet<T> depois que se sabe que nenhum novo elemento será adicionado. Para limpar completamente um objeto HashSet<T> e liberar toda a memória referenciada por ele, chame esse método depois de chamar o método Clear.

Esse método é uma operação O(n), em que n é Count.

Aplica-se a

TrimExcess(Int32)

Origem:
HashSet.cs

Define a capacidade de um objeto HashSet<T> para o número especificado de entradas, arredondado para um valor específico de implementação próximo.

public:
 void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

Parâmetros

capacity
Int32

A nova capacidade.

Exceções

ArgumentOutOfRangeException

A capacidade especificada é menor que a contagem de entradas.

Aplica-se a