Queryable.Union Metoda

Definicja

Przestrzeń nazw:

System.Linq

Zestaw:

System.Linq.Queryable.dll

Tworzy zbiór dwóch sekwencji.

Przeciążenia

Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>)	Tworzy połączenie zestawu dwóch sekwencji przy użyciu domyślnego porównania równości.
Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Tworzy zestaw unii dwóch sekwencji przy użyciu określonego IEqualityComparer<T>.

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

Źródło:

Queryable.cs

Tworzy połączenie zestawu dwóch sekwencji przy użyciu domyślnego porównania równości.

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

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)

Parametry typu

TSource

Typ elementów sekwencji wejściowych.

Parametry

source1

IQueryable<TSource>

Sekwencja, której odrębne elementy tworzą pierwszy zestaw dla operacji union.

source2

IEnumerable<TSource>

Sekwencja, której odrębne elementy tworzą drugi zestaw operacji union.

Zwraca

IQueryable<TSource>

Element IQueryable<T> zawierający elementy z obu sekwencji wejściowych, z wyłączeniem duplikatów.

Wyjątki

ArgumentNullException

source1 lub source2 ma wartość null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) metody w celu uzyskania połączenia zestawu dwóch sekwencji.

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

Uwagi

Metoda Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) generuje obiekt MethodCallExpression , który reprezentuje wywołanie Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) siebie jako skonstruowaną metodę ogólną. Następnie przekazuje MethodCallExpression wartość do CreateQuery<TElement>(Expression) metody IQueryProvider reprezentowanej przez Provider właściwość parametru source1 .

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażeń reprezentującego wywołanie Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) , zależy od implementacji typu parametru source1 . Oczekiwane zachowanie polega na tym, że zbiór elementów w source1 obiekcie i source2 jest zwracany.

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

Źródło:

Queryable.cs

Tworzy zestaw unii dwóch sekwencji przy użyciu określonego 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);

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)

Parametry typu

TSource

Typ elementów sekwencji wejściowych.

Parametry

source1

IQueryable<TSource>

Sekwencja, której odrębne elementy tworzą pierwszy zestaw dla operacji union.

source2

IEnumerable<TSource>

Sekwencja, której odrębne elementy tworzą drugi zestaw operacji union.

comparer

IEqualityComparer<TSource>

Element IEqualityComparer<T> do porównywania wartości.

Zwraca

IQueryable<TSource>

Element IQueryable<T> zawierający elementy z obu sekwencji wejściowych, z wyłączeniem duplikatów.

Wyjątki

ArgumentNullException

source1 lub source2 ma wartość null.

Uwagi

Metoda Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) generuje obiekt MethodCallExpression , który reprezentuje wywołanie Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) siebie jako skonstruowaną metodę ogólną. Następnie przekazuje MethodCallExpression wartość do CreateQuery<TElement>(Expression) metody IQueryProvider reprezentowanej przez Provider właściwość parametru source1 .

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażeń reprezentującego wywołanie Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) , zależy od implementacji typu parametru source1 . Oczekiwane zachowanie polega na tym, że zbiór elementów w source1 obiekcie i source2 jest zwracany. Parametr comparer służy do porównywania wartości.