Queryable.Except Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.Queryable.dll

Produz a diferença de conjunto de duas sequências.

Sobrecargas

Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>)	Produz a diferença de conjunto de duas sequências usando o comparador de igualdade padrão para comparar os valores.
Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produz a diferença de conjunto de duas sequências usando o IEqualityComparer<T> especificado para comparar os valores.

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

Origem:

Queryable.cs

Produz a diferença de conjunto de duas sequências usando o comparador de igualdade padrão para comparar os valores.

C#

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

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

source1

IQueryable<TSource>

Um IQueryable<T> cujos elementos que não estão presentes também no source2 serão retornados.

source2

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos que também ocorrem na primeira sequência não aparecerão na sequência retornada.

Retornos

IQueryable<TSource>

Um IQueryable<T> que contém a diferença de conjunto das duas sequências.

Exceções

ArgumentNullException

source1 ou source2 é null.

Exemplos

O exemplo de código a seguir demonstra como usar Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) para retornar os elementos que aparecem apenas na primeira sequência de origem.

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

Comentários

O Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) método gera um MethodCallExpression que representa a própria chamada Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o CreateQuery<TElement>(Expression) método do IQueryProvider representado pela Provider propriedade dosource1 parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) depende da implementação do tipo do source1 parâmetro. O comportamento esperado é que todos os elementos em source1 são retornados, exceto aqueles que também estão em source2.

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

Origem:

Queryable.cs

Produz a diferença de conjunto de duas sequências usando o IEqualityComparer<T> especificado para comparar os valores.

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

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

source1

IQueryable<TSource>

Um IQueryable<T> cujos elementos que não estão presentes também no source2 serão retornados.

source2

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos que também ocorrem na primeira sequência não aparecerão na sequência retornada.

comparer

IEqualityComparer<TSource>

Um IEqualityComparer<T> para comparar valores.

Retornos

IQueryable<TSource>

Um IQueryable<T> que contém a diferença de conjunto das duas sequências.

Exceções

ArgumentNullException

source1 ou source2 é null.

Comentários

O Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) método gera um MethodCallExpression que representa a própria chamada Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o CreateQuery<TElement>(Expression) método do IQueryProvider representado pela Provider propriedade dosource1 parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) depende da implementação do tipo do source1 parâmetro. O comportamento esperado é que todos os elementos em source1 são retornados, exceto aqueles que também estão em source2e comparer são usados para comparar valores.