Queryable.Except メソッド

定義

2 つのシーケンスの差集合を生成します。Produces the set difference of two sequences.

オーバーロード

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

指定された IEqualityComparer<T> を使用して値を比較することにより、2 つのシーケンスの差集合を生成します。Produces the set difference of two sequences by using the specified IEqualityComparer<T> to compare values.

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

既定の等値比較子を使用して値を比較することにより、2 つのシーケンスの差集合を生成します。Produces the set difference of two sequences by using the default equality comparer to compare values.

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

指定された IEqualityComparer<T> を使用して値を比較することにより、2 つのシーケンスの差集合を生成します。Produces the set difference of two sequences by using the specified IEqualityComparer<T> to compare values.

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

入力シーケンスの要素の型。The type of the elements of the input sequences.

パラメーター

source1
IQueryable<TSource>

IQueryable<T> には含まれていないが、返される要素を含む source2An IQueryable<T> whose elements that are not also in source2 will be returned.

source2
IEnumerable<TSource>

最初のシーケンスにも含まれているが、返されたシーケンスには出現しない要素を含む IEnumerable<T>An IEnumerable<T> whose elements that also occur in the first sequence will not appear in the returned sequence.

comparer
IEqualityComparer<TSource>

値を比較する IEqualityComparer<T>An IEqualityComparer<T> to compare values.

戻り値

IQueryable<TSource>

2 つのシーケンスの差集合が格納されている IQueryable<T>An IQueryable<T> that contains the set difference of the two sequences.

例外

source1 、または source2nullです。source1 or source2 is null.

注釈

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) メソッドは、構築されたジェネリックメソッドとしての呼び出し Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 自体を表す MethodCallExpression を生成します。The Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) method generates a MethodCallExpression that represents calling Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) itself as a constructed generic method. 次に、source1 パラメーターの Provider プロパティによって表される IQueryProviderCreateQuery<TElement>(Expression) メソッドに MethodCallExpression を渡します。It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of thesource1 parameter.

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) の呼び出しを表す式ツリーを実行した結果として発生するクエリ動作は、source1 パラメーターの型の実装によって異なります。The query behavior that occurs as a result of executing an expression tree that represents calling Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) depends on the implementation of the type of the source1 parameter. 期待される動作は、source1 内のすべての要素が、source2にあるものを除いて返され、comparer を使用して値を比較することです。The expected behavior is that all the elements in source1 are returned except for those that are also in source2, and comparer is used to compare values.

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

既定の等値比較子を使用して値を比較することにより、2 つのシーケンスの差集合を生成します。Produces the set difference of two sequences by using the default equality comparer to compare values.

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

入力シーケンスの要素の型。The type of the elements of the input sequences.

パラメーター

source1
IQueryable<TSource>

IQueryable<T> には含まれていないが、返される要素を含む source2An IQueryable<T> whose elements that are not also in source2 will be returned.

source2
IEnumerable<TSource>

最初のシーケンスにも含まれているが、返されたシーケンスには出現しない要素を含む IEnumerable<T>An IEnumerable<T> whose elements that also occur in the first sequence will not appear in the returned sequence.

戻り値

IQueryable<TSource>

2 つのシーケンスの差集合が格納されている IQueryable<T>An IQueryable<T> that contains the set difference of the two sequences.

例外

source1 、または source2nullです。source1 or source2 is null.

次のコード例では、Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) を使用して、最初のソースシーケンスにのみ出現する要素を返す方法を示します。The following code example demonstrates how to use Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) to return those elements that only appear in the first source sequence.

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>) メソッドは、構築されたジェネリックメソッドとしての呼び出し Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) 自体を表す MethodCallExpression を生成します。The Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) method generates a MethodCallExpression that represents calling Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) itself as a constructed generic method. 次に、source1 パラメーターの Provider プロパティによって表される IQueryProviderCreateQuery<TElement>(Expression) メソッドに MethodCallExpression を渡します。It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of thesource1 parameter.

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) の呼び出しを表す式ツリーを実行した結果として発生するクエリ動作は、source1 パラメーターの型の実装によって異なります。The query behavior that occurs as a result of executing an expression tree that represents calling Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) depends on the implementation of the type of the source1 parameter. 期待される動作は、source1 内のすべての要素が、source2にも含まれているものを除き、返されることです。The expected behavior is that all the elements in source1 are returned except for those that are also in source2.

適用対象