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>) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource1 параметра .

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов 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>) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource1 параметра .

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