HpcLinqQueryable.AssumeRangePartition Method (IQueryable, Expression, IComparer, Boolean)

Indicates to LINQ to HPC that the specified set of records was divided into DSC files by using dynamic sampling to choose range separators, and by associating each DSC file with a range of values for a key that the specified function generated from the records. The range separators were sorted by using the specified sort order, and the specified custom comparison object was used to compare the keys to the range separators.


Namespace: Microsoft.Hpc.Linq
Assembly: Microsoft.Hpc.Linq (in Microsoft.Hpc.Linq.dll)

'Usage
Dim source As IQueryable(Of TSource)
Dim keySelector As Expression(Of Func(Of TSource, TKey))
Dim comparer As IComparer(Of TKey)
Dim isDescending As Boolean
Dim returnValue As IQueryable(Of TSource)

returnValue = HpcLinqQueryable.AssumeRangePartition(source, keySelector, comparer, isDescending)

[ExtensionAttribute] 
public static IQueryable<TSource> AssumeRangePartition<TSource,TKey> (
	IQueryable<TSource> source,
	Expression<Func<TSource,TKey>> keySelector,
	IComparer<TKey> comparer,
	bool isDescending
)
J# supports the use of generic APIs, but not the declaration of new ones.
JScript does not support generic types or methods.

GenericParameters

TSource

The type of the records in the source parameter.

TKey

The return type of the function that you specify in the keySelector parameter to generate the key from a record.

Parameters

source

A System.Linq.IQueryable<TSource> interface for the set of records that you divided into DSC files based on the range matched by a value generated from each record.

keySelector

A System.Linq.Expressions.Expression(Func(TSource, TKey)) object that specifies a function that generated a key from each record. The range partition operation divides the records into DSC files by using the value of this key.

comparer

An IComparer<TKey> interface that you used for comparing the key for a record to the range separators and for sorting the records.

isDescending

A Boolean that specifies whether the range separators for the DSC file were sorted in descending order. True specifies that the range separators were sorted in descending order, so that the records with the largest values were placed in the first DSC file. False specifies that the range separators were sorted in ascending order, so that the records with the smallest values were placed in the first DSC file.

If the value of the parameter does not match the order in which the range separators are sorted in the array that the rangeSeparators parameter specifies, an exception occurs.

Return Value

The same IQueryable interface that you specified in the source parameter.

Exception typeCondition
ArgumentNullException

The specified source or keySelector parameter is a null reference (Nothing in Visual Basic).

In Visual Basic and C#, you can call this method as an instance method on any object of type IQueryable<TSource>. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

This method has at least one parameter of type Expression with a type argument that is one of the Func types. For these parameters, you can pass in a lambda expression and it compiles to an Expression.

Platform Note: This method was introduced in Windows HPC Server 2008 R2 with Service Pack 2 (SP2) and is not supported in previous versions.


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows XP, Windows Vista, Windows 7, Windows 8, Windows Server 2003, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012

Target Platforms

Windows XP, Windows Vista, Windows 7, Windows Server 2003, Windows Server 2003 R2, Windows Server 2008, Windows Server 2008 R2, with HPC Pack Client Utilities




Build Date:

2013-04-22
Show: