Queryable.Except Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
Produz a diferença de conjunto de duas sequências usando o comparador de igualdade padrão para comparar os 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);
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
- 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
Um IQueryable<T> que contém a diferença de conjunto das duas sequências.
Exceções
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.
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
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
.
Aplica-se a
Except<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
Produz a diferença de conjunto de duas sequências usando o IEqualityComparer<T> especificado para comparar os 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);
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)
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
Um IQueryable<T> que contém a diferença de conjunto das duas sequências.
Exceções
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 source2
e comparer
são usados para comparar valores.