ParallelEnumerable.OrderBy Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sorts in parallel the elements of a sequence in ascending order.
Overloads
OrderBy<TSource,TKey>(ParallelQuery<TSource>, Func<TSource,TKey>) |
Sorts in parallel the elements of a sequence in ascending order according to a key. |
OrderBy<TSource,TKey>(ParallelQuery<TSource>, Func<TSource,TKey>, IComparer<TKey>) |
Sorts in parallel the elements of a sequence in ascending order by using a specified comparer. |
OrderBy<TSource,TKey>(ParallelQuery<TSource>, Func<TSource,TKey>)
- Source:
- ParallelEnumerable.cs
- Source:
- ParallelEnumerable.cs
- Source:
- ParallelEnumerable.cs
Sorts in parallel the elements of a sequence in ascending order according to a key.
public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
static System::Linq::OrderedParallelQuery<TSource> ^ OrderBy(System::Linq::ParallelQuery<TSource> ^ source, Func<TSource, TKey> ^ keySelector);
public static System.Linq.OrderedParallelQuery<TSource> OrderBy<TSource,TKey> (this System.Linq.ParallelQuery<TSource> source, Func<TSource,TKey> keySelector);
static member OrderBy : System.Linq.ParallelQuery<'Source> * Func<'Source, 'Key> -> System.Linq.OrderedParallelQuery<'Source>
<Extension()>
Public Function OrderBy(Of TSource, TKey) (source As ParallelQuery(Of TSource), keySelector As Func(Of TSource, TKey)) As OrderedParallelQuery(Of TSource)
Type Parameters
- TSource
The type of elements of source
.
- TKey
The type of the key returned by keySelector
.
Parameters
- source
- ParallelQuery<TSource>
A sequence of values to order.
- keySelector
- Func<TSource,TKey>
A function to extract a key from an element.
Returns
An OrderedParallelQuery{TSource} whose elements are sorted according to a key.
Exceptions
source
or keySelector
is a null reference (Nothing in Visual Basic).
The query was canceled with the token passed in through WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).
One or more exceptions occurred during the evaluation of the query.
Remarks
In contrast to the sequential implementation, this is not a stable sort. To achieve a stable sort, change a query of the form: var ordered = source.Select((e,i) => new { E=e, I=i }).OrderBy((v) => v.e).ThenBy(v => v.i).Select((v) => v.e);
See also
Applies to
OrderBy<TSource,TKey>(ParallelQuery<TSource>, Func<TSource,TKey>, IComparer<TKey>)
- Source:
- ParallelEnumerable.cs
- Source:
- ParallelEnumerable.cs
- Source:
- ParallelEnumerable.cs
Sorts in parallel the elements of a sequence in ascending order by using a specified comparer.
public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
static System::Linq::OrderedParallelQuery<TSource> ^ OrderBy(System::Linq::ParallelQuery<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer);
public static System.Linq.OrderedParallelQuery<TSource> OrderBy<TSource,TKey> (this System.Linq.ParallelQuery<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey> comparer);
public static System.Linq.OrderedParallelQuery<TSource> OrderBy<TSource,TKey> (this System.Linq.ParallelQuery<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);
static member OrderBy : System.Linq.ParallelQuery<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IComparer<'Key> -> System.Linq.OrderedParallelQuery<'Source>
<Extension()>
Public Function OrderBy(Of TSource, TKey) (source As ParallelQuery(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IComparer(Of TKey)) As OrderedParallelQuery(Of TSource)
Type Parameters
- TSource
The type of elements of source
.
- TKey
The type of the key returned by keySelector
.
Parameters
- source
- ParallelQuery<TSource>
A sequence of values to order.
- keySelector
- Func<TSource,TKey>
A function to extract a key from an element.
- comparer
- IComparer<TKey>
An IComparer{TKey} to compare keys.
Returns
An OrderedParallelQuery{TSource} whose elements are sorted according to a key.
Exceptions
source
or keySelector
is a null reference (Nothing in Visual Basic).
The query was canceled with the token passed in through WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).
One or more exceptions occurred during the evaluation of the query.
Remarks
In contrast to the sequential implementation, this is not a stable sort. See the remarks for OrderBy for an approach to implementing a stable sort.