Distinct(TSource) Método (IEnumerable(TSource), IEqualityComparer(TSource))
Recolher sumário
Expandir sumário
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método Enumerable.Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)

 

Retorna os elementos distintos de uma sequência usando IEqualityComparer<T> especificado para comparar valores.

Namespace:   System.Linq
Assembly:  System.Core (em System.Core.dll)

public static IEnumerable<TSource> Distinct<TSource>(
	this IEnumerable<TSource> source,
	IEqualityComparer<TSource> comparer
)

Parâmetros

source

A sequência para remover os elementos de duplicados.

comparer

Um IEqualityComparer<T> para comparar os valores.

Valor de retorno

Type: System.Collections.Generic.IEnumerable<TSource>

IEnumerable<T> que contém os elementos distintos da sequência de origem.

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Exception Condition
ArgumentNullException

source é null.

Esse método é implementado usando a execução diferida.O valor de retorno imediato é um objeto que armazena todas as informações necessárias para executar a ação.A consulta representada por esse método não é executada até que o objeto seja enumerado chamando o método de GetEnumerator diretamente ou usando foreach em Visual C# ou For Each em Visual Basic.

O método de Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>) retorna uma sequência não ordenada que não contém nenhum valor duplicado.Se comparer é  uma referência nula (Nothing no Visual Basic), o comparador de igualdade padrão Default é usado para comparar valores.

O exemplo a seguir mostra como implementar um comparador de igualdade que pode ser usado no método do Distinct<TSource> .

public class Product
{
    public string Name { get; set; }
    public int Code { get; set; }
}

// Custom comparer for the Product class
class ProductComparer : IEqualityComparer<Product>
{
    // Products are equal if their names and product numbers are equal.
    public bool Equals(Product x, Product y)
    {

        //Check whether the compared objects reference the same data.
        if (Object.ReferenceEquals(x, y)) return true;

        //Check whether any of the compared objects is null.
        if (Object.ReferenceEquals(x, null) || Object.ReferenceEquals(y, null))
            return false;

        //Check whether the products' properties are equal.
        return x.Code == y.Code && x.Name == y.Name;
    }

    // If Equals() returns true for a pair of objects 
    // then GetHashCode() must return the same value for these objects.

    public int GetHashCode(Product product)
    {
        //Check whether the object is null
        if (Object.ReferenceEquals(product, null)) return 0;

        //Get hash code for the Name field if it is not null.
        int hashProductName = product.Name == null ? 0 : product.Name.GetHashCode();

        //Get hash code for the Code field.
        int hashProductCode = product.Code.GetHashCode();

        //Calculate the hash code for the product.
        return hashProductName ^ hashProductCode;
    }

}

Depois que você implementa esse comparador, você pode usar uma sequência de objetos de Product no método do Distinct<TSource> , conforme mostrado no exemplo a seguir.

Product[] products = { new Product { Name = "apple", Code = 9 }, 
                       new Product { Name = "orange", Code = 4 }, 
                       new Product { Name = "apple", Code = 9 }, 
                       new Product { Name = "lemon", Code = 12 } };

//Exclude duplicates.

IEnumerable<Product> noduplicates =
    products.Distinct(new ProductComparer());

foreach (var product in noduplicates)
    Console.WriteLine(product.Name + " " + product.Code);

/*
    This code produces the following output:
    apple 9 
    orange 4
    lemon 12
*/

Universal Windows Platform
Disponível desde 4.5
.NET Framework
Disponível desde 3.5
Portable Class Library
Com suporte em: portable .NET platforms
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao topo
Mostrar:
© 2016 Microsoft