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.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ DistinctBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector);

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

static member DistinctBy : seq<'Source> * Func<'Source, 'Key> -> seq<'Source>

<Extension()>
Public Function DistinctBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As IEnumerable(Of TSource)

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.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ DistinctBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);

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);

static member DistinctBy : seq<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IEqualityComparer<'Key> -> seq<'Source>

<Extension()>
Public Function DistinctBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IEqualityComparer(Of TKey)) As IEnumerable(Of TSource)

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