Прочитать на английском

Поделиться через


Queryable.Union Метод

Определение

Находит объединение множеств, представленных двумя последовательностями.

Перегрузки

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

Находит объединение множеств, представленных двумя последовательностями, используя для сравнения значений компаратор проверки на равенство по умолчанию.

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

Находит объединение множеств, представленных двумя последовательностями, используя указанный компаратор IEqualityComparer<T>.

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

Исходный код:
Queryable.cs
Исходный код:
Queryable.cs
Исходный код:
Queryable.cs

Находит объединение множеств, представленных двумя последовательностями, используя для сравнения значений компаратор проверки на равенство по умолчанию.

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

Параметры типа

TSource

Тип элементов входных последовательностей.

Параметры

source1
IQueryable<TSource>

Последовательность, различающиеся элементы которой образуют первое множество для операции объединения.

source2
IEnumerable<TSource>

Последовательность, различающиеся элементы которой образуют второе множество для операции объединения.

Возвращаемое значение

IQueryable<TSource>

Объект IQueryable<T>, который содержит элементы, имеющиеся в обеих входных последовательностях, кроме дубликатов.

Исключения

Параметр source1 или source2 имеет значение null.

Примеры

В следующем примере кода показано, как использовать Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) для получения объединения наборов двух последовательностей.

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

Комментарии

Метод Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) создает объект , MethodCallExpression представляющий вызов Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource1 параметра .

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) , зависит от реализации типа source1 параметра. Ожидаемое поведение заключается в том, что возвращается объединение наборов элементов в source1 и source2 .

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

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

Исходный код:
Queryable.cs
Исходный код:
Queryable.cs
Исходный код:
Queryable.cs

Находит объединение множеств, представленных двумя последовательностями, используя указанный компаратор IEqualityComparer<T>.

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

Параметры типа

TSource

Тип элементов входных последовательностей.

Параметры

source1
IQueryable<TSource>

Последовательность, различающиеся элементы которой образуют первое множество для операции объединения.

source2
IEnumerable<TSource>

Последовательность, различающиеся элементы которой образуют второе множество для операции объединения.

comparer
IEqualityComparer<TSource>

Компаратор IEqualityComparer<T>, используемый для сравнения значений.

Возвращаемое значение

IQueryable<TSource>

Объект IQueryable<T>, который содержит элементы, имеющиеся в обеих входных последовательностях, кроме дубликатов.

Исключения

Параметр source1 или source2 имеет значение null.

Комментарии

Метод Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) создает объект , MethodCallExpression представляющий вызов Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) как сконструированный универсальный метод. Затем он передает в MethodCallExpressionCreateQuery<TElement>(Expression) метод объекта , IQueryProvider представленный свойством Providersource1 параметра .

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) , зависит от реализации типа source1 параметра. Ожидаемое поведение заключается в том, что возвращается объединение наборов элементов в source1 и source2 . Параметр comparer используется для сравнения значений.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0