Enumerable.DistinctBy Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Sobrecargas

DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Retorna elementos distintos de uma sequência de acordo com uma função de seletor de chave especificada.
DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Retorna elementos distintos de uma sequência de acordo com uma função de seletor de chave especificada e usando um comparador especificado para comparar chaves.

DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Origem:

Distinct.cs

Retorna elementos distintos de uma sequência de acordo com uma função de seletor de chave especificada.

C#

public static System.Collections.Generic.IEnumerable<TSource> DistinctBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo de chave pelo qual distinguir elementos.

Parâmetros

source

IEnumerable<TSource>

A sequência da qual os elementos duplicados serão removidos.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

Retornos

IEnumerable<TSource>

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

Exceções

ArgumentNullException

source é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado 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 seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

O DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) método retorna uma sequência não ordenada que não contém valores duplicados. O comparador de igualdade padrão, Default, é usado para comparar valores.

Confira também

• Exemplos distinct e DistinctBy

DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

Origem:

Distinct.cs

Retorna elementos distintos de uma sequência de acordo com uma função de seletor de chave especificada e usando um comparador especificado para comparar chaves.

C#

public static System.Collections.Generic.IEnumerable<TSource> DistinctBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo de chave pelo qual distinguir elementos.

Parâmetros

source

IEnumerable<TSource>

A sequência da qual os elementos duplicados serão removidos.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

comparer

IEqualityComparer<TKey>

Um IEqualityComparer<T> para comparar chaves.

Retornos

IEnumerable<TSource>

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

Exceções

ArgumentNullException

source é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado 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 seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

O DistinctBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>) método retorna uma sequência não ordenada que não contém valores duplicados. Se comparer for null, o comparador de igualdade padrão, Default, será usado para comparar valores.

Confira também

• Exemplos distinct e DistinctBy