Queryable.Union Método

Definição

Produz a união conjunta de duas sequências.

Sobrecargas

Name Description
Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>)

Produz a união conjunta de duas sequências usando o comparador de igualdade padrão.

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

Produz a união de conjuntos de duas sequências usando um especificado IEqualityComparer<T>.

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

Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs

Produz a união conjunta de duas sequências usando o comparador de igualdade padrão.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Union(System::Linq::IQueryable<TSource> ^ source1, System::Collections::Generic::IEnumerable<TSource> ^ source2);
public static System.Linq.IQueryable<TSource> Union<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> Union<TSource>(this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2);
static member Union : 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 Union : System.Linq.IQueryable<'Source> * seq<'Source> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function Union(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>

Uma sequência cujos elementos distintos formam o primeiro conjunto para a operação de união.

source2
IEnumerable<TSource>

Uma sequência cujos elementos distintos formam o segundo conjunto para a operação de união.

Devoluções

IQueryable<TSource>

An IQueryable<T> que contém os elementos de ambas as sequências de entrada, excluindo duplicados.

Atributos

Exceções

source1 ou source2 é null.

Exemplos

O exemplo de código seguinte demonstra como usar Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) para obter a união de conjuntos de duas sequências.

int[] ints1 = { 5, 3, 9, 7, 5, 9, 3, 7 };
int[] ints2 = { 8, 3, 6, 4, 4, 9, 1, 0 };

// Get the set union of the items in the two arrays.
IEnumerable<int> union = ints1.AsQueryable().Union(ints2);

foreach (int num in union)
    Console.Write("{0} ", num);

/*
    This code produces the following output:

    5 3 9 7 8 6 4 1 0
*/
Dim ints1() As Integer = {5, 3, 9, 7, 5, 9, 3, 7}
Dim ints2() As Integer = {8, 3, 6, 4, 4, 9, 1, 0}

' Get the set union of the items in the two arrays.
Dim union = ints1.AsQueryable().Union(ints2)

Dim output As New System.Text.StringBuilder
For Each num As Integer In union
    output.Append(String.Format("{0} ", num))
Next

' Display the output.
MsgBox(output.ToString())

' This code produces the following output:

' 5 3 9 7 8 6 4 1 0

Observações

O Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) método gera um MethodCallExpression que representa o autodenominado Union<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 do source1 parâmetro.

O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões que representa a chamada Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) depende da implementação do tipo do source1 parâmetro. O comportamento esperado é que a união do conjunto dos elementos em source1 e source2 seja devolvida.

Aplica-se a

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

Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs

Produz a união de conjuntos de duas sequências usando um especificado IEqualityComparer<T>.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Union(System::Linq::IQueryable<TSource> ^ source1, System::Collections::Generic::IEnumerable<TSource> ^ source2, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);
public static System.Linq.IQueryable<TSource> Union<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> Union<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> Union<TSource>(this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2, System.Collections.Generic.IEqualityComparer<TSource>? comparer);
static member Union : 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 Union : System.Linq.IQueryable<'Source> * seq<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function Union(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 Genérico

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

source1
IQueryable<TSource>

Uma sequência cujos elementos distintos formam o primeiro conjunto para a operação de união.

source2
IEnumerable<TSource>

Uma sequência cujos elementos distintos formam o segundo conjunto para a operação de união.

comparer
IEqualityComparer<TSource>

E IEqualityComparer<T> para comparar valores.

Devoluções

IQueryable<TSource>

An IQueryable<T> que contém os elementos de ambas as sequências de entrada, excluindo duplicados.

Atributos

Exceções

source1 ou source2 é null.

Observações

O Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) método gera um MethodCallExpression que representa o autodenominado Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<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 do source1 parâmetro.

O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões que representa a chamada Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) depende da implementação do tipo do source1 parâmetro. O comportamento esperado é que a união do conjunto dos elementos em source1 e source2 seja devolvida. O comparer parâmetro é usado para comparar valores.

Aplica-se a