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>) 呼叫本身做為建構的泛型方法。 然後，它會將 傳遞MethodCallExpression至 CreateQuery<TElement>(Expression) 參數的 屬性所Provider表示的 source 方法IQueryProvider。

執行表示呼叫 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>) 呼叫本身做為建構的泛型方法。 然後，它會將 傳遞MethodCallExpression至 CreateQuery<TElement>(Expression) 參數的 屬性所Provider表示的 source 方法IQueryProvider。

執行表示呼叫 Distinct<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>) 的表達式樹狀結構所產生的查詢行為，取決於參數類型的 source 實作。 預期的行為是它會使用 comparer 來比較值，傳回 中source唯一專案的未排序序列。