Queryable.Distinct Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
Retorna os elementos distintos de uma sequência usando o comparador de igualdade padrão para comparar valores.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TSource> ^ Distinct(System::Linq::IQueryable<TSource> ^ source);public static System.Linq.IQueryable<TSource> Distinct<TSource> (this System.Linq.IQueryable<TSource> source);static member Distinct : System.Linq.IQueryable<'Source> -> System.Linq.IQueryable<'Source><Extension()>
Public Function Distinct(Of TSource) (source As IQueryable(Of TSource)) As IQueryable(Of TSource)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
Um IQueryable<T> que contém elementos distintos do source.
Exceções
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.
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
*/
Dim ages As List(Of Integer) = New List(Of Integer)(New Integer() {21, 46, 46, 55, 17, 21, 55, 55})
Dim distinctAges As IEnumerable(Of Integer) = ages.AsQueryable().Distinct()
Dim output As New System.Text.StringBuilder
output.AppendLine("Distinct ages:")
For Each age As Integer In distinctAges
output.AppendLine(age)
Next
' Display the output.
MsgBox(output.ToString())
' 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.
Aplica-se a
Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>)
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
Retorna os elementos distintos de uma sequência usando um IEqualityComparer<T> especificado para comparar valores.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TSource> ^ Distinct(System::Linq::IQueryable<TSource> ^ source, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);public static System.Linq.IQueryable<TSource> Distinct<TSource> (this System.Linq.IQueryable<TSource> source, System.Collections.Generic.IEqualityComparer<TSource> comparer);public static System.Linq.IQueryable<TSource> Distinct<TSource> (this System.Linq.IQueryable<TSource> source, System.Collections.Generic.IEqualityComparer<TSource>? comparer);static member Distinct : System.Linq.IQueryable<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> System.Linq.IQueryable<'Source><Extension()>
Public Function Distinct(Of TSource) (source As IQueryable(Of TSource), comparer As IEqualityComparer(Of TSource)) As IQueryable(Of TSource)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
Um IQueryable<T> que contém elementos distintos do source.
Exceções
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.
