HashSet<T> Construtores

Definição

Namespace:

System.Collections.Generic

Assemblies:

netstandard.dll, System.Collections.dll

Inicializa uma nova instância da classe HashSet<T>.

Sobrecargas

Nome	Description
HashSet<T>()	Inicializa uma nova instância da HashSet<T> classe que está vazia e usa o comparador de igualdade padrão para o tipo de conjunto.
HashSet<T>(IEnumerable<T>)	Inicializa uma nova instância da HashSet<T> classe que usa o comparador de igualdade padrão para o tipo de conjunto, contém elementos copiados da coleção especificada e tem capacidade suficiente para acomodar o número de elementos copiados.
HashSet<T>(IEqualityComparer<T>)	Inicializa uma nova instância da HashSet<T> classe que está vazia e usa o comparador de igualdade especificado para o tipo de conjunto.
HashSet<T>(Int32)	Inicializa uma nova instância da HashSet<T> classe que está vazia, mas tem espaço reservado para capacity itens e usa o comparador de igualdade padrão para o tipo de conjunto.
HashSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Inicializa uma nova instância da HashSet<T> classe que usa o comparador de igualdade especificado para o tipo de conjunto, contém elementos copiados da coleção especificada e tem capacidade suficiente para acomodar o número de elementos copiados.
HashSet<T>(Int32, IEqualityComparer<T>)	Inicializa uma nova instância da HashSet<T> classe que usa o comparador de igualdade especificado para o tipo de conjunto e tem capacidade suficiente para acomodar capacity elementos.
HashSet<T>(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da HashSet<T> classe com dados serializados.

HashSet<T>()

Origem:

HashSet.cs

Inicializa uma nova instância da HashSet<T> classe que está vazia e usa o comparador de igualdade padrão para o tipo de conjunto.

public:
 HashSet();

public HashSet();

Public Sub New ()

Exemplos

O exemplo a seguir demonstra como criar e preencher dois HashSet<T> objetos. Este exemplo faz parte de um exemplo maior fornecido para o UnionWith método.

HashSet<int> evenNumbers = new HashSet<int>();
HashSet<int> oddNumbers = new HashSet<int>();

for (int i = 0; i < 5; i++)
{
    // Populate numbers with just even numbers.
    evenNumbers.Add(i * 2);

    // Populate oddNumbers with just odd numbers.
    oddNumbers.Add((i * 2) + 1);
}

let evenNumbers = HashSet<int>()
let oddNumbers = HashSet<int>()

for i = 0 to 4 do
    // Populate numbers with just even numbers.
    evenNumbers.Add(i * 2) |> ignore

    // Populate oddNumbers with just odd numbers.
    oddNumbers.Add(i * 2 + 1) |> ignore

Dim evenNumbers As HashSet(Of Integer) = New HashSet(Of Integer)()
Dim oddNumbers As HashSet(Of Integer) = New HashSet(Of Integer)()

For i As Integer = 0 To 4

    ' Populate evenNumbers with only even numbers.
    evenNumbers.Add(i * 2)

    ' Populate oddNumbers with only odd numbers.
    oddNumbers.Add((i * 2) + 1)
Next i

Comentários

A capacidade de um HashSet<T> objeto é o número de elementos que o objeto pode conter. A capacidade de um HashSet<T> objeto aumenta automaticamente à medida que os elementos são adicionados ao objeto.

Esse construtor é uma operação O(1).

HashSet<T>(IEnumerable<T>)

Origem:

HashSet.cs

Inicializa uma nova instância da HashSet<T> classe que usa o comparador de igualdade padrão para o tipo de conjunto, contém elementos copiados da coleção especificada e tem capacidade suficiente para acomodar o número de elementos copiados.

public:
 HashSet(System::Collections::Generic::IEnumerable<T> ^ collection);

public HashSet(System.Collections.Generic.IEnumerable<T> collection);

new System.Collections.Generic.HashSet<'T> : seq<'T> -> System.Collections.Generic.HashSet<'T>

Public Sub New (collection As IEnumerable(Of T))

Parâmetros

collection

IEnumerable<T>

A coleção cujos elementos são copiados para o novo conjunto.

Exceções

ArgumentNullException

collection é null.

Exemplos

O exemplo a seguir mostra como criar uma HashSet<T> coleção de um conjunto existente. Neste exemplo, dois conjuntos são criados com inteiros pares e ímpares, respectivamente. Em seguida, um terceiro HashSet<T> objeto é criado a partir do conjunto de inteiros par.

HashSet<int> evenNumbers = new HashSet<int>();
HashSet<int> oddNumbers = new HashSet<int>();

for (int i = 0; i < 5; i++)
{
    // Populate numbers with just even numbers.
    evenNumbers.Add(i * 2);

    // Populate oddNumbers with just odd numbers.
    oddNumbers.Add((i * 2) + 1);
}

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

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

// Create a new HashSet populated with even numbers.
HashSet<int> numbers = new HashSet<int>(evenNumbers);
Console.WriteLine("numbers UnionWith oddNumbers...");
numbers.UnionWith(oddNumbers);

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

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

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

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

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

    printfn " }"

let evenNumbers = HashSet<int>()
let oddNumbers = HashSet<int>()

for i = 0 to 4 do
    // Populate numbers with just even numbers.
    evenNumbers.Add(i * 2) |> ignore

    // Populate oddNumbers with just odd numbers.
    oddNumbers.Add(i * 2 + 1) |> ignore

printf $"evenNumbers contains {evenNumbers.Count} elements: "
displaySet evenNumbers

printf $"oddNumbers contains {oddNumbers.Count} elements: "
displaySet oddNumbers

// Create a new HashSet populated with even numbers.
let numbers = HashSet<int> evenNumbers
printfn "numbers UnionWith oddNumbers..."
numbers.UnionWith oddNumbers

printf $"numbers contains {numbers.Count} elements: "
displaySet numbers
// This example produces output similar to the following:
//    evenNumbers contains 5 elements: { 0 2 4 6 8 }
//    oddNumbers contains 5 elements: { 1 3 5 7 9 }
//    numbers UnionWith oddNumbers...
//    numbers contains 10 elements: { 0 2 4 6 8 1 3 5 7 9 }

Shared Sub Main()

    Dim evenNumbers As HashSet(Of Integer) = New HashSet(Of Integer)()
    Dim oddNumbers As HashSet(Of Integer) = New HashSet(Of Integer)()

    For i As Integer = 0 To 4

        ' Populate evenNumbers with only even numbers.
        evenNumbers.Add(i * 2)

        ' Populate oddNumbers with only odd numbers.
        oddNumbers.Add((i * 2) + 1)
    Next i

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

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

    ' Create a new HashSet populated with even numbers.
    Dim numbers As HashSet(Of Integer) = New HashSet(Of Integer)(evenNumbers)
    Console.WriteLine("numbers UnionWith oddNumbers...")
    numbers.UnionWith(oddNumbers)

    Console.Write("numbers contains {0} elements: ", numbers.Count)
    DisplaySet(numbers)
End Sub

Comentários

A capacidade de um HashSet<T> objeto é o número de elementos que o objeto pode conter. A capacidade de um HashSet<T> objeto aumenta automaticamente à medida que os elementos são adicionados ao objeto.

Se collection contiver duplicatas, o conjunto conterá um de cada elemento exclusivo. Nenhuma exceção será gerada. Portanto, o tamanho do conjunto resultante não é idêntico ao tamanho de collection.

Esse construtor é uma operação O(n), onde n está o número de elementos no collection parâmetro.

HashSet<T>(IEqualityComparer<T>)

Origem:

HashSet.cs

Inicializa uma nova instância da HashSet<T> classe que está vazia e usa o comparador de igualdade especificado para o tipo de conjunto.

public:
 HashSet(System::Collections::Generic::IEqualityComparer<T> ^ comparer);

public HashSet(System.Collections.Generic.IEqualityComparer<T>? comparer);

new System.Collections.Generic.HashSet<'T> : System.Collections.Generic.IEqualityComparer<'T> -> System.Collections.Generic.HashSet<'T>

Public Sub New (comparer As IEqualityComparer(Of T))

Parâmetros

comparer

IEqualityComparer<T>

A IEqualityComparer<T> implementação a ser usada ao comparar valores no conjunto ou null usar a implementação padrão EqualityComparer<T> para o tipo de conjunto.

Comentários

A capacidade de um HashSet<T> objeto é o número de elementos que o objeto pode conter. A capacidade de um HashSet<T> objeto aumenta automaticamente à medida que os elementos são adicionados ao objeto.

Esse construtor é uma operação O(1).

HashSet<T>(Int32)

Origem:

HashSet.cs

Inicializa uma nova instância da HashSet<T> classe que está vazia, mas tem espaço reservado para capacity itens e usa o comparador de igualdade padrão para o tipo de conjunto.

public:
 HashSet(int capacity);

public HashSet(int capacity);

new System.Collections.Generic.HashSet<'T> : int -> System.Collections.Generic.HashSet<'T>

Public Sub New (capacity As Integer)

Parâmetros

capacity

Int32

O tamanho inicial do HashSet<T>.

Comentários

Como os redimensionamentos são relativamente caros (exigem reexibição), isso tenta minimizar a necessidade de redimensionar definindo a capacidade inicial com base no valor do capacity.

Cuidado

Se capacity vier da entrada do usuário, prefira usar uma sobrecarga de construtor sem um capacity parâmetro e deixe a coleção redimensionar à medida que os elementos forem adicionados. Se você precisar usar um valor especificado pelo usuário, fixe-o a um limite razoável (por exemplo), Math.Clamp(untrustedValue, 0, 20)ou verifique se a contagem de elementos corresponde ao valor especificado.

HashSet<T>(IEnumerable<T>, IEqualityComparer<T>)

Origem:

HashSet.cs

Inicializa uma nova instância da HashSet<T> classe que usa o comparador de igualdade especificado para o tipo de conjunto, contém elementos copiados da coleção especificada e tem capacidade suficiente para acomodar o número de elementos copiados.

public:
 HashSet(System::Collections::Generic::IEnumerable<T> ^ collection, System::Collections::Generic::IEqualityComparer<T> ^ comparer);

public HashSet(System.Collections.Generic.IEnumerable<T> collection, System.Collections.Generic.IEqualityComparer<T>? comparer);

new System.Collections.Generic.HashSet<'T> : seq<'T> * System.Collections.Generic.IEqualityComparer<'T> -> System.Collections.Generic.HashSet<'T>

Public Sub New (collection As IEnumerable(Of T), comparer As IEqualityComparer(Of T))

Parâmetros

collection

IEnumerable<T>

A coleção cujos elementos são copiados para o novo conjunto.

comparer

IEqualityComparer<T>

A IEqualityComparer<T> implementação a ser usada ao comparar valores no conjunto ou null usar a implementação padrão EqualityComparer<T> para o tipo de conjunto.

Exceções

ArgumentNullException

collection é null.

Exemplos

O exemplo a seguir usa um fornecido IEqualityComparer<T> para permitir comparações que não diferenciam maiúsculas de minúsculas nos elementos de uma HashSet<T> coleção de tipos de veículos.

HashSet<string> allVehicles = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
List<string> someVehicles = new List<string>();

someVehicles.Add("Planes");
someVehicles.Add("Trains");
someVehicles.Add("Automobiles");

// Add in the vehicles contained in the someVehicles list.
allVehicles.UnionWith(someVehicles);

Console.WriteLine("The current HashSet contains:\n");
foreach (string vehicle in allVehicles)
{
    Console.WriteLine(vehicle);
}

allVehicles.Add("Ships");
allVehicles.Add("Motorcycles");
allVehicles.Add("Rockets");
allVehicles.Add("Helicopters");
allVehicles.Add("Submarines");

Console.WriteLine("\nThe updated HashSet contains:\n");
foreach (string vehicle in allVehicles)
{
    Console.WriteLine(vehicle);
}

// Verify that the 'All Vehicles' set contains at least the vehicles in
// the 'Some Vehicles' list.
if (allVehicles.IsSupersetOf(someVehicles))
{
    Console.Write("\nThe 'All' vehicles set contains everything in ");
    Console.WriteLine("'Some' vechicles list.");
}

// Check for Rockets. Here the OrdinalIgnoreCase comparer will compare
// true for the mixed-case vehicle type.
if (allVehicles.Contains("roCKeTs"))
{
    Console.WriteLine("\nThe 'All' vehicles set contains 'roCKeTs'");
}

allVehicles.ExceptWith(someVehicles);
Console.WriteLine("\nThe excepted HashSet contains:\n");
foreach (string vehicle in allVehicles)
{
    Console.WriteLine(vehicle);
}

// Remove all the vehicles that are not 'super cool'.
allVehicles.RemoveWhere(isNotSuperCool);

Console.WriteLine("\nThe super cool vehicles are:\n");
foreach (string vehicle in allVehicles)
{
    Console.WriteLine(vehicle);
}

// Predicate to determine vehicle 'coolness'.
bool isNotSuperCool(string vehicle)
{
    bool superCool = (vehicle == "Helicopters") || (vehicle == "Motorcycles");

    return !superCool;
}

// The program writes the following output to the console.
//
// The current HashSet contains:
//
// Planes
// Trains
// Automobiles
//
// The updated HashSet contains:
//
// Planes
// Trains
// Automobiles
// Ships
// Motorcycles
// Rockets
// Helicopters
// Submarines
//
// The 'All' vehicles set contains everything in 'Some' vechicles list.
//
// The 'All' vehicles set contains 'roCKeTs'
//
// The excepted HashSet contains:
//
// Ships
// Motorcycles
// Rockets
// Helicopters
// Submarines
//
// The super cool vehicles are:
//
// Motorcycles
// Helicopters

let allVehicles = HashSet<string> StringComparer.OrdinalIgnoreCase
let someVehicles = ResizeArray()

someVehicles.Add "Planes"
someVehicles.Add "Trains"
someVehicles.Add "Automobiles"

// Add in the vehicles contained in the someVehicles list.
allVehicles.UnionWith someVehicles

printfn "The current HashSet contains:\n"

for vehicle in allVehicles do
    printfn $"{vehicle}"

allVehicles.Add "Ships" |> ignore
allVehicles.Add "Motorcycles" |> ignore
allVehicles.Add "Rockets" |> ignore
allVehicles.Add "Helicopters" |> ignore
allVehicles.Add "Submarines" |> ignore

printfn "\nThe updated HashSet contains:\n"

for vehicle in allVehicles do
    printfn $"{vehicle}"

// Verify that the 'All Vehicles' set contains at least the vehicles in
// the 'Some Vehicles' list.
if allVehicles.IsSupersetOf someVehicles then
    printfn "\nThe 'All' vehicles set contains everything in 'Some' vehicles list."

// Check for Rockets. Here the OrdinalIgnoreCase comparer will compare
// true for the mixed-case vehicle type.
if allVehicles.Contains "roCKeTs" then
    printfn "\nThe 'All' vehicles set contains 'roCKeTs'"

allVehicles.ExceptWith someVehicles
printfn "\nThe excepted HashSet contains:\n"

for vehicle in allVehicles do
    printfn $"{vehicle}"

// Predicate to determine vehicle 'coolness'.
let isNotSuperCool vehicle =
    let superCool = vehicle = "Helicopters" || vehicle = "Motorcycles"
    not superCool

// Remove all the vehicles that are not 'super cool'.
allVehicles.RemoveWhere isNotSuperCool |> ignore

printfn "\nThe super cool vehicles are:\n"

for vehicle in allVehicles do
    printfn $"{vehicle}"

// The program writes the following output to the console.
//
// The current HashSet contains:
//
// Planes
// Trains
// Automobiles
//
// The updated HashSet contains:
//
// Planes
// Trains
// Automobiles
// Ships
// Motorcycles
// Rockets
// Helicopters
// Submarines
//
// The 'All' vehicles set contains everything in 'Some' vehicles list.
//
// The 'All' vehicles set contains 'roCKeTs'
//
// The excepted HashSet contains:
//
// Ships
// Motorcycles
// Rockets
// Helicopters
// Submarines
//
// The super cool vehicles are:
//
// Motorcycles
// Helicopters

Imports System.Collections.Generic

Class Program
    Public Shared Sub Main()
        Dim allVehicles As New HashSet(Of String)(StringComparer.OrdinalIgnoreCase)
        Dim someVehicles As New List(Of String)()

        someVehicles.Add("Planes")
        someVehicles.Add("Trains")
        someVehicles.Add("Automobiles")

        ' Add in the vehicles contained in the someVehicles list.
        allVehicles.UnionWith(someVehicles)

        Console.WriteLine("The current HashSet contains:" + Environment.NewLine)
        For Each vehicle As String In allVehicles
            Console.WriteLine(vehicle)
        Next vehicle

        allVehicles.Add("Ships")
        allVehicles.Add("Motorcycles")
        allVehicles.Add("Rockets")
        allVehicles.Add("Helicopters")
        allVehicles.Add("Submarines")

        Console.WriteLine(Environment.NewLine + "The updated HashSet contains:" + Environment.NewLine)
        For Each vehicle As String In allVehicles
            Console.WriteLine(vehicle)
        Next vehicle

        ' Verify that the 'All Vehicles' set contains at least the vehicles in
        ' the 'Some Vehicles' list.
        If allVehicles.IsSupersetOf(someVehicles) Then
            Console.Write(Environment.NewLine + "The 'All' vehicles set contains everything in ")
            Console.WriteLine("'Some' vechicles list.")
        End If

        ' Check for Rockets. Here the OrdinalIgnoreCase comparer will compare
        ' True for the mixed-case vehicle type.
        If allVehicles.Contains("roCKeTs") Then
            Console.WriteLine(Environment.NewLine + "The 'All' vehicles set contains 'roCKeTs'")
        End If

        allVehicles.ExceptWith(someVehicles)
        Console.WriteLine(Environment.NewLine + "The excepted HashSet contains:" + Environment.NewLine)
        For Each vehicle As String In allVehicles
            Console.WriteLine(vehicle)
        Next vehicle

        ' Remove all the vehicles that are not 'super cool'.
        allVehicles.RemoveWhere(AddressOf isNotSuperCool)

        Console.WriteLine(Environment.NewLine + "The super cool vehicles are:" + Environment.NewLine)
        For Each vehicle As String In allVehicles
            Console.WriteLine(vehicle)
        Next vehicle
    End Sub

    ' Predicate to determine vehicle 'coolness'.
    Private Shared Function isNotSuperCool(vehicle As String) As Boolean
        Dim notSuperCool As Boolean = _
            (vehicle <> "Helicopters") And (vehicle <> "Motorcycles")

        Return notSuperCool
    End Function
End Class

'
' The program writes the following output to the console.
'
' The current HashSet contains:
'
' Planes
' Trains
' Automobiles
'
' The updated HashSet contains:
'
' Planes
' Trains
' Automobiles
' Ships
' Motorcycles
' Rockets
' Helicopters
' Submarines
'
' The 'All' vehicles set contains everything in 'Some' vechicles list.
'
' The 'All' vehicles set contains 'roCKeTs'
'
' The excepted HashSet contains:
'
' Ships
' Motorcycles
' Rockets
' Helicopters
' Submarines
'
' The super cool vehicles are:
'
' Motorcycles
' Helicopters

Comentários

A capacidade de um HashSet<T> objeto é o número de elementos que o objeto pode conter. A capacidade de um HashSet<T> objeto aumenta automaticamente à medida que os elementos são adicionados ao objeto.

Se collection contiver duplicatas, o conjunto conterá um de cada elemento exclusivo. Nenhuma exceção será gerada. Portanto, o tamanho do conjunto resultante não é idêntico ao tamanho de collection.

Esse construtor é uma operação O(n), onde n está o número de elementos no collection parâmetro.

HashSet<T>(Int32, IEqualityComparer<T>)

Origem:

HashSet.cs

Inicializa uma nova instância da HashSet<T> classe que usa o comparador de igualdade especificado para o tipo de conjunto e tem capacidade suficiente para acomodar capacity elementos.

public:
 HashSet(int capacity, System::Collections::Generic::IEqualityComparer<T> ^ comparer);

public HashSet(int capacity, System.Collections.Generic.IEqualityComparer<T>? comparer);

new System.Collections.Generic.HashSet<'T> : int * System.Collections.Generic.IEqualityComparer<'T> -> System.Collections.Generic.HashSet<'T>

Public Sub New (capacity As Integer, comparer As IEqualityComparer(Of T))

Parâmetros

capacity

Int32

O tamanho inicial do HashSet<T>.

comparer

IEqualityComparer<T>

A IEqualityComparer<T> implementação a ser usada ao comparar valores no conjunto ou nulo (Nothing no Visual Basic) para usar a implementação padrão IEqualityComparer<T> para o tipo de conjunto.

Comentários

Como os redimensionamentos são relativamente caros (exigem reexibição), isso tenta minimizar a necessidade de redimensionar definindo a capacidade inicial com base no valor do capacity.

Cuidado

Se capacity vier da entrada do usuário, prefira usar uma sobrecarga de construtor sem um capacity parâmetro e deixe a coleção redimensionar à medida que os elementos forem adicionados. Se você precisar usar um valor especificado pelo usuário, fixe-o a um limite razoável (por exemplo), Math.Clamp(untrustedValue, 0, 20)ou verifique se a contagem de elementos corresponde ao valor especificado.

HashSet<T>(SerializationInfo, StreamingContext)

Origem:

HashSet.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da HashSet<T> classe com dados serializados.

protected:
 HashSet(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected HashSet(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Collections.Generic.HashSet<'T> : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Generic.HashSet<'T>

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info

SerializationInfo

Um SerializationInfo objeto que contém as informações necessárias para serializar o HashSet<T> objeto.

context

StreamingContext

Uma StreamingContext estrutura que contém a origem e o destino do fluxo serializado associado ao HashSet<T> objeto.

Atributos

ObsoleteAttribute

Comentários

Esse construtor é chamado durante a desserialização para reconstituir um objeto transmitido por um fluxo. Para obter mais informações, consulte de serialização XML e SOAP.