Queryable.Except メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.Queryable.dll

2 つのシーケンスのセット差を生成します。

オーバーロード

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>)	既定の等値比較子を使用して値を比較することにより、2 つのシーケンスのセット差を生成します。
Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	指定した IEqualityComparer<T> を使用して値を比較することにより、2 つのシーケンスのセット差を生成します。

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

ソース:

Queryable.cs

既定の等値比較子を使用して値を比較することにより、2 つのシーケンスのセット差を生成します。

C#

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

型パラメーター

TSource

入力シーケンスの要素の型。

パラメーター

source1

IQueryable<TSource>

source2 に含まれていない要素が返される IQueryable<T>。

source2

IEnumerable<TSource>

最初のシーケンスでも発生する要素が、返されるシーケンスに表示されない IEnumerable<T>。

戻り値

IQueryable<TSource>

2 つのシーケンスのセット差を含む IQueryable<T>。

例外

ArgumentNullException

source1 または source2 が null。

例

次のコード例では、Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) を使用して、最初のソース シーケンスにのみ表示される要素を返す方法を示します。

C#

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
*/

注釈

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) メソッドは、構築されたジェネリック メソッドとしての呼び出し自体 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) 表す MethodCallExpression を生成します。 次に、source1 パラメーターの Provider プロパティで表される IQueryProvider の CreateQuery<TElement>(Expression) メソッドに MethodCallExpression を渡します。

呼び出し Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) を表す式ツリーを実行した結果として発生するクエリ動作は、source1 パラメーターの型の実装によって異なります。 予期される動作は、source1 内のすべての要素が、source2内にある要素を除いて返されるということです。

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

ソース:

Queryable.cs

指定した IEqualityComparer<T> を使用して値を比較することにより、2 つのシーケンスのセット差を生成します。

C#

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

型パラメーター

TSource

入力シーケンスの要素の型。

パラメーター

source1

IQueryable<TSource>

source2 に含まれていない要素が返される IQueryable<T>。

source2

IEnumerable<TSource>

最初のシーケンスでも発生する要素が、返されるシーケンスに表示されない IEnumerable<T>。

comparer

IEqualityComparer<TSource>

値を比較する IEqualityComparer<T>。

戻り値

IQueryable<TSource>

2 つのシーケンスのセット差を含む IQueryable<T>。

例外

ArgumentNullException

source1 または source2 が null。

注釈

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) メソッドは、構築されたジェネリック メソッドとしての呼び出し自体 Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 表す MethodCallExpression を生成します。 次に、source1 パラメーターの Provider プロパティで表される IQueryProvider の CreateQuery<TElement>(Expression) メソッドに MethodCallExpression を渡します。

呼び出し Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) を表す式ツリーを実行した結果として発生するクエリ動作は、source1 パラメーターの型の実装によって異なります。 予期される動作は、source1 内のすべての要素が返され、source2内にある要素を除き、comparer を使用して値を比較することです。