ParallelEnumerable.Union Method

Definition

Namespace:

System.Linq

Assembly:

System.Linq.Parallel.dll

Produces the set union of two parallel sequences.

Overloads

Union<TSource>(ParallelQuery<TSource>, IEnumerable<TSource>)	Obsolete. This Union overload should never be called. This method is marked as obsolete and always throws NotSupportedException when called.
Union<TSource>(ParallelQuery<TSource>, ParallelQuery<TSource>)	Produces the set union of two parallel sequences by using the default equality comparer.
Union<TSource>(ParallelQuery<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Obsolete. This Union overload should never be called. This method is marked as obsolete and always throws NotSupportedException when called.
Union<TSource>(ParallelQuery<TSource>, ParallelQuery<TSource>, IEqualityComparer<TSource>)	Produces the set union of two parallel sequences by using a specified IEqualityComparer{T}.

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

Source:

ParallelEnumerable.cs

Caution

The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.

This Union overload should never be called. This method is marked as obsolete and always throws NotSupportedException when called.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TSource> ^ Union(System::Linq::ParallelQuery<TSource> ^ first, System::Collections::Generic::IEnumerable<TSource> ^ second);

[System.Obsolete("The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.")]
public static System.Linq.ParallelQuery<TSource> Union<TSource> (this System.Linq.ParallelQuery<TSource> first, System.Collections.Generic.IEnumerable<TSource> second);

[<System.Obsolete("The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.")>]
static member Union : System.Linq.ParallelQuery<'Source> * seq<'Source> -> System.Linq.ParallelQuery<'Source>

<Extension()>
Public Function Union(Of TSource) (first As ParallelQuery(Of TSource), second As IEnumerable(Of TSource)) As ParallelQuery(Of TSource)

Type Parameters

TSource

This type parameter is not used.

Parameters

first

ParallelQuery<TSource>

This parameter is not used.

second

IEnumerable<TSource>

This parameter is not used.

Returns

ParallelQuery<TSource>

This overload always throws a NotSupportedException.

Attributes

ObsoleteAttribute

Exceptions

NotSupportedException

The exception that occurs when this method is called.

OperationCanceledException

The query was canceled with the token passed in through WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

AggregateException

One or more exceptions occurred during the evaluation of the query.

Remarks

This overload exists to disallow usage of Union with a left data source of type ParallelQuery<TSource> and a right data source of type IEnumerable<T>. Otherwise, the Union operator would appear to be binding to the parallel implementation, but would in reality bind to sequential implementation.

See also

• Parallel LINQ (PLINQ)

Union<TSource>(ParallelQuery<TSource>, ParallelQuery<TSource>)

Source:

ParallelEnumerable.cs

Produces the set union of two parallel sequences by using the default equality comparer.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TSource> ^ Union(System::Linq::ParallelQuery<TSource> ^ first, System::Linq::ParallelQuery<TSource> ^ second);

public static System.Linq.ParallelQuery<TSource> Union<TSource> (this System.Linq.ParallelQuery<TSource> first, System.Linq.ParallelQuery<TSource> second);

static member Union : System.Linq.ParallelQuery<'Source> * System.Linq.ParallelQuery<'Source> -> System.Linq.ParallelQuery<'Source>

<Extension()>
Public Function Union(Of TSource) (first As ParallelQuery(Of TSource), second As ParallelQuery(Of TSource)) As ParallelQuery(Of TSource)

Type Parameters

TSource

The type of the elements of the input sequences.

Parameters

first

ParallelQuery<TSource>

A sequence whose distinct elements form the first set for the union.

second

ParallelQuery<TSource>

A sequence whose distinct elements form the second set for the union.

Returns

ParallelQuery<TSource>

A sequence that contains the elements from both input sequences, excluding duplicates.

Exceptions

ArgumentNullException

first or second is a null reference (Nothing in Visual Basic).

OperationCanceledException

The query was canceled with the token passed in through WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

AggregateException

One or more exceptions occurred during the evaluation of the query.

See also

• Parallel LINQ (PLINQ)

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

Source:

ParallelEnumerable.cs

Caution

The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.

This Union overload should never be called. This method is marked as obsolete and always throws NotSupportedException when called.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TSource> ^ Union(System::Linq::ParallelQuery<TSource> ^ first, System::Collections::Generic::IEnumerable<TSource> ^ second, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);

[System.Obsolete("The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.")]
public static System.Linq.ParallelQuery<TSource> Union<TSource> (this System.Linq.ParallelQuery<TSource> first, System.Collections.Generic.IEnumerable<TSource> second, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

[<System.Obsolete("The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.")>]
static member Union : System.Linq.ParallelQuery<'Source> * seq<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> System.Linq.ParallelQuery<'Source>

<Extension()>
Public Function Union(Of TSource) (first As ParallelQuery(Of TSource), second As IEnumerable(Of TSource), comparer As IEqualityComparer(Of TSource)) As ParallelQuery(Of TSource)

Type Parameters

TSource

This type parameter is not used.

Parameters

first

ParallelQuery<TSource>

This parameter is not used.

second

IEnumerable<TSource>

This parameter is not used.

comparer

IEqualityComparer<TSource>

This parameter is not used.

Returns

ParallelQuery<TSource>

This overload always throws a NotSupportedException.

Attributes

ObsoleteAttribute

Exceptions

NotSupportedException

The exception that occurs when this method is called.

OperationCanceledException

The query was canceled with the token passed in through WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

AggregateException

One or more exceptions occurred during the evaluation of the query.

Remarks

This overload exists to disallow usage of Union with a left data source of type ParallelQuery<TSource> and a right data source of type IEnumerable<T>. Otherwise, the Union operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.

See also

• Parallel LINQ (PLINQ)

Union<TSource>(ParallelQuery<TSource>, ParallelQuery<TSource>, IEqualityComparer<TSource>)

Source:

ParallelEnumerable.cs

Produces the set union of two parallel sequences by using a specified IEqualityComparer{T}.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TSource> ^ Union(System::Linq::ParallelQuery<TSource> ^ first, System::Linq::ParallelQuery<TSource> ^ second, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);

public static System.Linq.ParallelQuery<TSource> Union<TSource> (this System.Linq.ParallelQuery<TSource> first, System.Linq.ParallelQuery<TSource> second, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

static member Union : System.Linq.ParallelQuery<'Source> * System.Linq.ParallelQuery<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> System.Linq.ParallelQuery<'Source>

<Extension()>
Public Function Union(Of TSource) (first As ParallelQuery(Of TSource), second As ParallelQuery(Of TSource), comparer As IEqualityComparer(Of TSource)) As ParallelQuery(Of TSource)

Type Parameters

TSource

The type of the elements of the input sequences.

Parameters

first

ParallelQuery<TSource>

A sequence whose distinct elements form the first set for the union.

second

ParallelQuery<TSource>

A sequence whose distinct elements form the second set for the union.

comparer

IEqualityComparer<TSource>

An IEqualityComparer<T> to compare values.

Returns

ParallelQuery<TSource>

A sequence that contains the elements from both input sequences, excluding duplicates.

Exceptions

ArgumentNullException

first or second is a null reference (Nothing in Visual Basic).

OperationCanceledException

The query was canceled with the token passed in through WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

AggregateException

One or more exceptions occurred during the evaluation of the query.

See also

• Parallel LINQ (PLINQ)