ParallelEnumerable.Except Method

Definition

Namespace:

System.Linq

Assembly:

System.Linq.Parallel.dll

Produces the set difference of two parallel sequences.

Overloads

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

Except<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 Except 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> ^ Except(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> Except<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 Except : System.Linq.ParallelQuery<'Source> * seq<'Source> -> System.Linq.ParallelQuery<'Source>

<Extension()>
Public Function Except(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.

Remarks

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

See also

• Parallel LINQ (PLINQ)

Except<TSource>(ParallelQuery<TSource>, ParallelQuery<TSource>)

Source:

ParallelEnumerable.cs

Produces the set difference of two parallel sequences by using the default equality comparer to compare values.

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

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

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

<Extension()>
Public Function Except(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 elements that are not also in second will be returned.

second

ParallelQuery<TSource>

A sequence whose elements that also occur in the first sequence will cause those elements to be removed from the returned sequence.

Returns

ParallelQuery<TSource>

A sequence that contains the set difference of the elements of two sequences.

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)

Except<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 Except 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> ^ Except(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> Except<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 Except : System.Linq.ParallelQuery<'Source> * seq<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> System.Linq.ParallelQuery<'Source>

<Extension()>
Public Function Except(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.

Remarks

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

See also

• Parallel LINQ (PLINQ)

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

Source:

ParallelEnumerable.cs

Produces the set difference of two parallel sequences by using the specified IEqualityComparer<T> to compare values.

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

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

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

<Extension()>
Public Function Except(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 elements that are not also in second will be returned.

second

ParallelQuery<TSource>

A sequence whose elements that also occur in the first sequence will cause those elements to be removed from the returned sequence.

comparer

IEqualityComparer<TSource>

IEqualityComparer<T> to compare values.

Returns

ParallelQuery<TSource>

A sequence that contains the set difference of the elements of two sequences.

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)