Queryable.Except 方法

定義

命名空間:

System.Linq

組件:

System.Linq.Queryable.dll

產生兩個序列的差異。

多載

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>)	使用預設相等比較子來比較值，以便產生兩個序列的差異。
Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T> 來比較值，以便產生兩個序列的差異。

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>)

來源:

Queryable.cs

使用預設相等比較子來比較值，以便產生兩個序列的差異。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Except(System::Linq::IQueryable<TSource> ^ source1, System::Collections::Generic::IEnumerable<TSource> ^ source2);

public static System.Linq.IQueryable<TSource> Except<TSource> (this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2);

static member Except : System.Linq.IQueryable<'Source> * seq<'Source> -> System.Linq.IQueryable<'Source>

<Extension()>
Public Function Except(Of TSource) (source1 As IQueryable(Of TSource), source2 As IEnumerable(Of TSource)) As IQueryable(Of TSource)

類型參數

TSource

輸入序列之項目的類型。

參數

source1

IQueryable<TSource>

IQueryable<T>，其項目若未同時存在 source2 中，便會傳回這些項目。

source2

IEnumerable<TSource>

IEnumerable<T>，其項目若同時出現在第一個序列中，則不會出現在傳回的序列中。

傳回

IQueryable<TSource>

IQueryable<T>，其中包含兩個序列的差異。

例外狀況

ArgumentNullException

source1 或 source2 為 null。

範例

下列程式代碼範例示範如何使用 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) 傳回只出現在第一個來源序列中的專案。

double[] numbers1 = { 2.0, 2.1, 2.2, 2.3, 2.4, 2.5 };
double[] numbers2 = { 2.2 };

// Get the numbers from the first array that
// are NOT in the second array.
IEnumerable<double> onlyInFirstSet =
    numbers1.AsQueryable().Except(numbers2);

foreach (double number in onlyInFirstSet)
    Console.WriteLine(number);

/*
    This code produces the following output:

    2
    2.1
    2.3
    2.4
    2.5
*/

Dim numbers1() As Double = {2.0, 2.1, 2.2, 2.3, 2.4, 2.5}
Dim numbers2() As Double = {2.2}

' Get the numbers from the first array that
' are NOT in the second array.
Dim onlyInFirstSet As IEnumerable(Of Double) = _
    numbers1.AsQueryable().Except(numbers2)

Dim output As New System.Text.StringBuilder
For Each number As Double In onlyInFirstSet
    output.AppendLine(number)
Next

' Display the output.
MsgBox(output.ToString())

' This code produces the following output:
'
' 2
' 2.1
' 2.3
' 2.4
' 2.5

備註

方法 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) 會產生 ， MethodCallExpression 表示 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) 呼叫本身做為建構的泛型方法。 然後，它會將 傳遞MethodCallExpression至 CreateQuery<TElement>(Expression) 參數的 屬性所Provider表示的source1方法IQueryProvider。

執行表示呼叫 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) 的表達式樹狀結構所產生的查詢行為，取決於參數類型的 source1 實作。 預期的行為是 中所有元素 source1 都會傳回，但 中也 source2傳回的專案除外。

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)

來源:

Queryable.cs

使用指定的 IEqualityComparer<T> 來比較值，以便產生兩個序列的差異。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Except(System::Linq::IQueryable<TSource> ^ source1, System::Collections::Generic::IEnumerable<TSource> ^ source2, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);

public static System.Linq.IQueryable<TSource> Except<TSource> (this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

static member Except : System.Linq.IQueryable<'Source> * seq<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> System.Linq.IQueryable<'Source>

<Extension()>
Public Function Except(Of TSource) (source1 As IQueryable(Of TSource), source2 As IEnumerable(Of TSource), comparer As IEqualityComparer(Of TSource)) As IQueryable(Of TSource)

類型參數

TSource

輸入序列之項目的類型。

參數

source1

IQueryable<TSource>

IQueryable<T>，其項目若未同時存在 source2 中，便會傳回這些項目。

source2

IEnumerable<TSource>

IEnumerable<T>，其項目若同時出現在第一個序列中，則不會出現在傳回的序列中。

comparer

IEqualityComparer<TSource>

用來比較值的 IEqualityComparer<T>。

傳回

IQueryable<TSource>

IQueryable<T>，其中包含兩個序列的差異。

例外狀況

ArgumentNullException

source1 或 source2 為 null。

備註

方法 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 會產生 ， MethodCallExpression 表示 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 呼叫本身做為建構的泛型方法。 然後，它會將 傳遞MethodCallExpression至 CreateQuery<TElement>(Expression) 參數的 屬性所Provider表示的source1方法IQueryProvider。

執行表示呼叫 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 的表達式樹狀結構所產生的查詢行為，取決於參數類型的 source1 實作。 預期的行為是 會傳回 中所有元素，但 也source2位於 的source1元素除外，並且comparer用來比較值。