Queryable.Distinct Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.Queryable.dll

Retorna elementos diferentes de uma sequência.

Sobrecargas

Distinct<TSource>(IQueryable<TSource>)	Retorna os elementos distintos de uma sequência usando o comparador de igualdade padrão para comparar valores.
Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>)	Retorna os elementos distintos de uma sequência usando um IEqualityComparer<T> especificado para comparar valores.

Distinct<TSource>(IQueryable<TSource>)

Origem:

Queryable.cs

Retorna os elementos distintos de uma sequência usando o comparador de igualdade padrão para comparar valores.

C#

public static System.Linq.IQueryable<TSource> Distinct<TSource> (this System.Linq.IQueryable<TSource> source);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IQueryable<TSource>

O IQueryable<T> do qual as duplicatas serão removidas.

Retornos

IQueryable<TSource>

Um IQueryable<T> que contém elementos distintos do source.

Exceções

ArgumentNullException

source é null.

Exemplos

O exemplo de código a seguir demonstra como usar Distinct<TSource>(IQueryable<TSource>) para retornar elementos distintos de uma sequência.

C#

List<int> ages = new List<int> { 21, 46, 46, 55, 17, 21, 55, 55 };

IEnumerable<int> distinctAges = ages.AsQueryable().Distinct();

Console.WriteLine("Distinct ages:");

foreach (int age in distinctAges)
    Console.WriteLine(age);

/*
    This code produces the following output:

    Distinct ages:
    21
    46
    55
    17
*/

Comentários

O Distinct<TSource>(IQueryable<TSource>) método gera um MethodCallExpression que representa chamar Distinct<TSource>(IQueryable<TSource>) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o CreateQuery<TElement>(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Distinct<TSource>(IQueryable<TSource>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que ele retorna uma sequência não ordenada dos itens exclusivos em source.

Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>)

Origem:

Queryable.cs

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

C#

public static System.Linq.IQueryable<TSource> Distinct<TSource> (this System.Linq.IQueryable<TSource> source, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IQueryable<TSource>

O IQueryable<T> do qual as duplicatas serão removidas.

comparer

IEqualityComparer<TSource>

Um IEqualityComparer<T> para comparar valores.

Retornos

IQueryable<TSource>

Um IQueryable<T> que contém elementos distintos do source.

Exceções

ArgumentNullException

source ou comparer é null.

Comentários

O Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>) método gera um MethodCallExpression que representa chamar Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o CreateQuery<TElement>(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que ele retorna uma sequência não ordenada dos itens exclusivos no source usando comparer para comparar valores.