Queryable.Distinct Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.Queryable.dll

Возвращает различающиеся элементы последовательности.

Перегрузки

Distinct<TSource>(IQueryable<TSource>)	Возвращает различающиеся элементы последовательности, используя для сравнения значений компаратор проверки на равенство по умолчанию.
Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>)	Возвращает различающиеся элементы последовательности, используя для сравнения значений указанный компаратор IEqualityComparer<T>.

Distinct<TSource>(IQueryable<TSource>)

Исходный код:

Queryable.cs

Возвращает различающиеся элементы последовательности, используя для сравнения значений компаратор проверки на равенство по умолчанию.

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)

Параметры типа

TSource

Тип элементов source.

Параметры

source

IQueryable<TSource>

Объект IQueryable<T>, из которого требуется удалить дубликаты.

Возвращаемое значение

IQueryable<TSource>

Объект IQueryable<T>, содержащий различающиеся элементы из последовательности source.

Исключения

ArgumentNullException

source имеет значение null.

Примеры

В следующем примере кода показано, как использовать Distinct<TSource>(IQueryable<TSource>) для возврата отдельных элементов из последовательности.

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

Комментарии

Метод Distinct<TSource>(IQueryable<TSource>) создает объект , MethodCallExpression представляющий вызов Distinct<TSource>(IQueryable<TSource>) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource параметра .

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов Distinct<TSource>(IQueryable<TSource>) , зависит от реализации типа source параметра. Ожидаемое поведение заключается в том, что он возвращает неупорядоченную последовательность уникальных элементов в source.

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

Исходный код:

Queryable.cs

Возвращает различающиеся элементы последовательности, используя для сравнения значений указанный компаратор IEqualityComparer<T>.

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

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)

Параметры типа

TSource

Тип элементов source.

Параметры

source

IQueryable<TSource>

Объект IQueryable<T>, из которого требуется удалить дубликаты.

comparer

IEqualityComparer<TSource>

Компаратор IEqualityComparer<T>, используемый для сравнения значений.

Возвращаемое значение

IQueryable<TSource>

Объект IQueryable<T>, содержащий различающиеся элементы из последовательности source.

Исключения

ArgumentNullException

Параметр source или comparer имеет значение null.

Комментарии

Метод Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>) создает объект , MethodCallExpression представляющий вызов Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource параметра .

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>) , зависит от реализации типа source параметра. Ожидаемое поведение заключается в том, что он возвращает неупорядоченную последовательность уникальных элементов в source с помощью comparer для сравнения значений.