Queryable.Except Метод

Определение

Находит разность множеств, представленных двумя последовательностями.Produces the set difference of two sequences.

Перегрузки

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

Находит разность множеств, представленных двумя последовательностями, используя для сравнения значений указанный компаратор IEqualityComparer<T>.Produces the set difference of two sequences by using the specified IEqualityComparer<T> to compare values.

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

Находит разность множеств, представленных двумя последовательностями, используя для сравнения значений компаратор проверки на равенство по умолчанию.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>.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);
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>, из которого требуется извлечь элементы, отсутствующие в последовательности source2.An 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>

Объект IQueryable<T>, являющийся разностью двух последовательностей как множеств.An IQueryable<T> that contains the set difference of the two sequences.

Исключения

Параметр source1 или source2 имеет значение null.source1 or source2 is null.

Комментарии

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)Метод создает объект MethodCallExpression , который представляет вызов Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) самого себя как сконструированного универсального метода.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. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source1 параметра.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>)

Находит разность множеств, представленных двумя последовательностями, используя для сравнения значений компаратор проверки на равенство по умолчанию.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>, из которого требуется извлечь элементы, отсутствующие в последовательности source2.An 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>

Объект IQueryable<T>, являющийся разностью двух последовательностей как множеств.An IQueryable<T> that contains the set difference of the two sequences.

Исключения

Параметр source1 или source2 имеет значение null.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>)Метод создает объект MethodCallExpression , который представляет вызов Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) самого себя как сконструированного универсального метода.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. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source1 параметра.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.

Применяется к