Queryable.Except Método

Definição

Espaço de Nomes:: System.Linq

Assemblagens:: System.Core.dll, System.Linq.Queryable.dll

Assemblagens:: netstandard.dll, System.Linq.Queryable.dll

Assemblagem:: System.Linq.Queryable.dll

Assemblagem:: System.Core.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>)	Produz a diferença de conjuntos de duas sequências usando o comparador de igualdade por defeito para comparar valores.
Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produz a diferença de conjuntos de duas sequências usando o especificado IEqualityComparer<T> para comparar valores.

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

Origem:: Queryable.cs

Origem:: Queryable.cs

Origem:: Queryable.cs

Origem:: Queryable.cs

Origem:: Queryable.cs

Produz a diferença de conjuntos de duas sequências usando o comparador de igualdade por defeito para comparar valores.

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")]
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>

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")>]
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)

Parâmetros de Tipo Genérico

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

source1: IQueryable<TSource>

E cujos IQueryable<T> elementos que também não estão em source2 será devolvido.

source2: IEnumerable<TSource>

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

Devoluções

IQueryable<TSource>

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

Atributos: RequiresDynamicCodeAttribute

Exceções

ArgumentNullException

source1 ou source2 é null.

Exemplos

O exemplo de código seguinte demonstra como usar Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) para devolver aqueles elementos que só aparecem na primeira sequência fonte.

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

Observações

O Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) método gera um MethodCallExpression que representa o autodenominado Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>) como um método genérico construído. Depois passa o MethodCallExpression para o CreateQuery<TElement>(Expression) método de o IQueryProvider representado pela Provider propriedade dosource1 parâmetro.

O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões 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 sejam devolvidos, exceto aqueles que também estão em source2.

Aplica-se a

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

Origem:: Queryable.cs

Origem:: Queryable.cs

Origem:: Queryable.cs

Origem:: Queryable.cs

Origem:: Queryable.cs

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

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")]
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>

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")>]
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)