Partitioner.Create 方法

定义

命名空间:

System.Collections.Concurrent

程序集:

System.Collections.Concurrent.dll

创建分区程序。

重载

Create(Int32, Int32)	创建一个按用户指定的范围划分区块的分区程序。
Create(Int64, Int64)	创建一个按用户指定的范围划分区块的分区程序。
Create(Int32, Int32, Int32)	创建一个按用户指定的范围划分区块的分区程序。
Create(Int64, Int64, Int64)	创建一个按用户指定的范围划分区块的分区程序。
Create<TSource>(IEnumerable<TSource>)	从 IEnumerable<T> 实例创建一个可排序分区程序。
Create<TSource>(IEnumerable<TSource>, EnumerablePartitionerOptions)	从 IEnumerable<T> 实例创建一个可排序分区程序。
Create<TSource>(IList<TSource>, Boolean)	从 IList<T> 实例创建一个可排序分区程序。
Create<TSource>(TSource[], Boolean)	从 Array 实例创建一个可排序分区程序。

Create(Int32, Int32)

Source:

PartitionerStatic.cs

创建一个按用户指定的范围划分区块的分区程序。

public:
 static System::Collections::Concurrent::OrderablePartitioner<Tuple<int, int> ^> ^ Create(int fromInclusive, int toExclusive);

public static System.Collections.Concurrent.OrderablePartitioner<Tuple<int,int>> Create (int fromInclusive, int toExclusive);

static member Create : int * int -> System.Collections.Concurrent.OrderablePartitioner<int * int>

Public Shared Function Create (fromInclusive As Integer, toExclusive As Integer) As OrderablePartitioner(Of Tuple(Of Integer, Integer))

参数

fromInclusive

Int32

范围下限（含）。

toExclusive

Int32

范围上限（不含）。

返回

OrderablePartitioner<Tuple<Int32,Int32>>

一个分区程序。

例外

ArgumentOutOfRangeException

toExclusive 参数小于或等于 fromInclusive 参数。

注解

有关详细信息和示例，请参阅 PLINQ 和 TPL 的自定义分区程序。

另请参阅

• PLINQ 和 TPL 的自定义分区程序
• 如何：加快小型循环主体的速度
• 如何：使用静态分区数实现分区程序

Create(Int64, Int64)

Source:

PartitionerStatic.cs

创建一个按用户指定的范围划分区块的分区程序。

public:
 static System::Collections::Concurrent::OrderablePartitioner<Tuple<long, long> ^> ^ Create(long fromInclusive, long toExclusive);

public static System.Collections.Concurrent.OrderablePartitioner<Tuple<long,long>> Create (long fromInclusive, long toExclusive);

static member Create : int64 * int64 -> System.Collections.Concurrent.OrderablePartitioner<int64 * int64>

Public Shared Function Create (fromInclusive As Long, toExclusive As Long) As OrderablePartitioner(Of Tuple(Of Long, Long))

参数

fromInclusive

Int64

范围下限（含）。

toExclusive

Int64

范围上限（不含）。

返回

OrderablePartitioner<Tuple<Int64,Int64>>

一个分区程序。

例外

ArgumentOutOfRangeException

toExclusive 参数小于或等于 fromInclusive 参数。

注解

有关详细信息和示例，请参阅 PLINQ 和 TPL 的自定义分区程序。

另请参阅

• PLINQ 和 TPL 的自定义分区程序
• 如何：加快小型循环主体的速度
• 如何：使用静态分区数实现分区程序

Create(Int32, Int32, Int32)

Source:

PartitionerStatic.cs

创建一个按用户指定的范围划分区块的分区程序。

public:
 static System::Collections::Concurrent::OrderablePartitioner<Tuple<int, int> ^> ^ Create(int fromInclusive, int toExclusive, int rangeSize);

public static System.Collections.Concurrent.OrderablePartitioner<Tuple<int,int>> Create (int fromInclusive, int toExclusive, int rangeSize);

static member Create : int * int * int -> System.Collections.Concurrent.OrderablePartitioner<int * int>

Public Shared Function Create (fromInclusive As Integer, toExclusive As Integer, rangeSize As Integer) As OrderablePartitioner(Of Tuple(Of Integer, Integer))

参数

fromInclusive

Int32

范围下限（含）。

toExclusive

Int32

范围上限（不含）。

rangeSize

Int32

每个子范围的大小。

返回

OrderablePartitioner<Tuple<Int32,Int32>>

一个分区程序。

例外

ArgumentOutOfRangeException

toExclusive 参数小于或等于 fromInclusive 参数。

- 或 -

rangeSize 参数小于或等于 0。

注解

有关详细信息和示例，请参阅 PLINQ 和 TPL 的自定义分区程序。

另请参阅

• PLINQ 和 TPL 的自定义分区程序
• 如何：加快小型循环主体的速度
• 如何：使用静态分区数实现分区程序

Create(Int64, Int64, Int64)

Source:

PartitionerStatic.cs

创建一个按用户指定的范围划分区块的分区程序。

public:
 static System::Collections::Concurrent::OrderablePartitioner<Tuple<long, long> ^> ^ Create(long fromInclusive, long toExclusive, long rangeSize);

public static System.Collections.Concurrent.OrderablePartitioner<Tuple<long,long>> Create (long fromInclusive, long toExclusive, long rangeSize);

static member Create : int64 * int64 * int64 -> System.Collections.Concurrent.OrderablePartitioner<int64 * int64>

Public Shared Function Create (fromInclusive As Long, toExclusive As Long, rangeSize As Long) As OrderablePartitioner(Of Tuple(Of Long, Long))

参数

fromInclusive

Int64

范围下限（含）。

toExclusive

Int64

范围上限（不含）。

rangeSize

Int64

每个子范围的大小。

返回

OrderablePartitioner<Tuple<Int64,Int64>>

一个分区程序。

例外

ArgumentOutOfRangeException

toExclusive 参数小于或等于 fromInclusive 参数。

- 或 -

rangeSize 参数小于或等于 0。

注解

有关详细信息和示例，请参阅 PLINQ 和 TPL 的自定义分区程序。

另请参阅

• PLINQ 和 TPL 的自定义分区程序
• 如何：加快小型循环主体的速度
• 如何：使用静态分区数实现分区程序

Create<TSource>(IEnumerable<TSource>)

Source:

PartitionerStatic.cs

从 IEnumerable<T> 实例创建一个可排序分区程序。

public:
generic <typename TSource>
 static System::Collections::Concurrent::OrderablePartitioner<TSource> ^ Create(System::Collections::Generic::IEnumerable<TSource> ^ source);

public static System.Collections.Concurrent.OrderablePartitioner<TSource> Create<TSource> (System.Collections.Generic.IEnumerable<TSource> source);

static member Create : seq<'Source> -> System.Collections.Concurrent.OrderablePartitioner<'Source>

Public Shared Function Create(Of TSource) (source As IEnumerable(Of TSource)) As OrderablePartitioner(Of TSource)

类型参数

TSource

源可枚举项中的元素的类型。

参数

source

IEnumerable<TSource>

要进行分区的可枚举项。

返回

OrderablePartitioner<TSource>

基于输入数组的可排序分区程序。

注解

在创建的分区程序中使用的排序由从源枚举中检索到的元素的自然顺序确定。 有关详细信息和示例，请参阅 PLINQ 和 TPL 的自定义分区程序。

另请参阅

• PLINQ 和 TPL 的自定义分区程序
• 如何：加快小型循环主体的速度
• 如何：实现动态分区

Create<TSource>(IEnumerable<TSource>, EnumerablePartitionerOptions)

Source:

PartitionerStatic.cs

从 IEnumerable<T> 实例创建一个可排序分区程序。

public:
generic <typename TSource>
 static System::Collections::Concurrent::OrderablePartitioner<TSource> ^ Create(System::Collections::Generic::IEnumerable<TSource> ^ source, System::Collections::Concurrent::EnumerablePartitionerOptions partitionerOptions);

public static System.Collections.Concurrent.OrderablePartitioner<TSource> Create<TSource> (System.Collections.Generic.IEnumerable<TSource> source, System.Collections.Concurrent.EnumerablePartitionerOptions partitionerOptions);

static member Create : seq<'Source> * System.Collections.Concurrent.EnumerablePartitionerOptions -> System.Collections.Concurrent.OrderablePartitioner<'Source>

Public Shared Function Create(Of TSource) (source As IEnumerable(Of TSource), partitionerOptions As EnumerablePartitionerOptions) As OrderablePartitioner(Of TSource)

类型参数

TSource

源可枚举项中的元素的类型。

参数

source

IEnumerable<TSource>

要进行分区的可枚举项。

partitionerOptions

EnumerablePartitionerOptions

控制分区缓冲行为的选项。

返回

OrderablePartitioner<TSource>

基于输入数组的可排序分区程序。

例外

ArgumentOutOfRangeException

partitionerOptions 参数为 EnumerablePartitionerOptions 指定无效值。

注解

在创建的分区程序中使用的排序由从源枚举中检索到的元素的自然顺序确定。

Create<TSource>(IList<TSource>, Boolean)

Source:

PartitionerStatic.cs

从 IList<T> 实例创建一个可排序分区程序。

public:
generic <typename TSource>
 static System::Collections::Concurrent::OrderablePartitioner<TSource> ^ Create(System::Collections::Generic::IList<TSource> ^ list, bool loadBalance);

public static System.Collections.Concurrent.OrderablePartitioner<TSource> Create<TSource> (System.Collections.Generic.IList<TSource> list, bool loadBalance);

static member Create : System.Collections.Generic.IList<'Source> * bool -> System.Collections.Concurrent.OrderablePartitioner<'Source>

Public Shared Function Create(Of TSource) (list As IList(Of TSource), loadBalance As Boolean) As OrderablePartitioner(Of TSource)

类型参数

TSource

源列表中的元素的类型。

参数

list

IList<TSource>

要进行分区的列表。

loadBalance

Boolean

一个布尔值，该值指示创建的分区程序是否应在各分区之间保持动态负载平衡，而不是静态负载平衡。

返回

OrderablePartitioner<TSource>

基于输入列表的可排序分区程序。

注解

有关详细信息和示例，请参阅 PLINQ 和 TPL 的自定义分区程序。

另请参阅

• PLINQ 和 TPL 的自定义分区程序
• 如何：加快小型循环主体的速度
• 如何：实现动态分区

Create<TSource>(TSource[], Boolean)

Source:

PartitionerStatic.cs

从 Array 实例创建一个可排序分区程序。

public:
generic <typename TSource>
 static System::Collections::Concurrent::OrderablePartitioner<TSource> ^ Create(cli::array <TSource> ^ array, bool loadBalance);

public static System.Collections.Concurrent.OrderablePartitioner<TSource> Create<TSource> (TSource[] array, bool loadBalance);

static member Create : 'Source[] * bool -> System.Collections.Concurrent.OrderablePartitioner<'Source>

Public Shared Function Create(Of TSource) (array As TSource(), loadBalance As Boolean) As OrderablePartitioner(Of TSource)

类型参数

TSource

源数组中的元素的类型。

参数

array

TSource[]

要进行分区的数组。

loadBalance

Boolean

一个布尔值，该值指示创建的分区程序是否应在各分区之间保持动态负载平衡，而不是静态负载平衡。

返回

OrderablePartitioner<TSource>

基于输入数组的可排序分区程序。

注解

有关详细信息和示例，请参阅 PLINQ 和 TPL 的自定义分区程序。

另请参阅

• PLINQ 和 TPL 的自定义分区程序
• 如何：加快小型循环主体的速度
• 如何：实现动态分区