TaskFactory<TResult>.StartNew 方法

定义

命名空间:

System.Threading.Tasks

程序集:

System.Runtime.dll

创建并启动 任务。

重载

StartNew(Func<Object,TResult>, Object, CancellationToken)	创建并启动 任务。
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	创建并启动 任务。
StartNew(Func<TResult>, TaskCreationOptions)	创建并启动 任务。
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	创建并启动 任务。
StartNew(Func<Object,TResult>, Object)	创建并启动 任务。
StartNew(Func<TResult>)	创建并启动 任务。
StartNew(Func<TResult>, CancellationToken)	创建并启动 任务。
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	创建并启动 任务。

StartNew(Func<Object,TResult>, Object, CancellationToken)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

参数

function

Func<Object,TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

state

Object

包含 function 委托所用数据的对象。

cancellationToken

CancellationToken

将指派给新的任务的取消标记。

返回

Task<TResult>

已启动的任务。

例外

ObjectDisposedException

已释放创建 cancellationToken 的取消标记源。

ArgumentNullException

function 参数为 null。

注解

调用 StartNew 在功能上等效于使用构造函数之 Task<TResult> 一创建任务，然后调用 Start 方法以计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议采用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用

StartNew(Func<Object,TResult>, Object, TaskCreationOptions)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

参数

function

Func<Object,TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

state

Object

包含 function 委托所用数据的对象。

creationOptions

TaskCreationOptions

控制所创建的任务的行为的枚举值之一。

返回

Task<TResult>

已启动的任务。

例外

ArgumentNullException

function 参数为 null。

ArgumentOutOfRangeException

creationOptions 参数指定的值无效。

注解

调用 StartNew 在功能上等效于使用构造函数之 Task<TResult> 一创建任务，然后调用 Start 方法以计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议采用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用

StartNew(Func<TResult>, TaskCreationOptions)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

参数

function

Func<TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

creationOptions

TaskCreationOptions

控制所创建的任务的行为的枚举值之一。

返回

Task<TResult>

已启动的 Task<TResult>。

例外

ArgumentNullException

function 参数为 null。

ArgumentOutOfRangeException

creationOptions 参数指定的值无效。

注解

调用 StartNew 在功能上等效于使用构造函数之 Task<TResult> 一创建任务，然后调用 Start 方法以计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议采用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用

StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

参数

function

Func<TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

cancellationToken

CancellationToken

将指派给新的任务的取消标记。

creationOptions

TaskCreationOptions

控制所创建的任务的行为的枚举值之一。

scheduler

TaskScheduler

用于计划所创建的任务的任务计划程序。

返回

Task<TResult>

已启动的任务。

例外

ObjectDisposedException

已释放创建 cancellationToken 的取消标记源。

ArgumentNullException

function 参数为 null。

- 或 -

scheduler 参数为 null。

ArgumentOutOfRangeException

creationOptions 参数指定的值无效。

注解

调用 StartNew 在功能上等效于使用构造函数之 Task<TResult> 一创建任务，然后调用 Start 方法以计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议采用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用

StartNew(Func<Object,TResult>, Object)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state);

member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)

参数

function

Func<Object,TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

state

Object

包含 function 委托所用数据的对象。

返回

Task<TResult>

已启动的任务。

例外

ArgumentNullException

function 参数为 null。

注解

调用 StartNew 在功能上等效于使用构造函数之 Task<TResult> 一创建任务，然后调用 Start 方法以计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议采用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用

StartNew(Func<TResult>)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function);

member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult)) As Task(Of TResult)

参数

function

Func<TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

返回

Task<TResult>

已启动的任务。

例外

ArgumentNullException

function 参数为 null。

注解

调用 StartNew 在功能上等效于使用构造函数之 Task<TResult> 一创建任务，然后调用 Start 方法来计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议采用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用

StartNew(Func<TResult>, CancellationToken)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

参数

function

Func<TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

cancellationToken

CancellationToken

将指派给新的任务的取消标记。

返回

Task<TResult>

已启动的任务。

例外

ObjectDisposedException

已释放创建 cancellationToken 的取消标记源。

ArgumentNullException

function 参数为 null。

注解

调用 StartNew 在功能上等效于使用构造函数之 Task<TResult> 一创建任务，然后调用 Start 方法以计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议采用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用

StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

Source:

FutureFactory.cs

创建并启动 任务。

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

参数

function

Func<Object,TResult>

一个函数委托，可返回能够通过任务获得的将来结果。

state

Object

包含 function 委托所用数据的对象。

cancellationToken

CancellationToken

将指派给新的任务的取消标记。

creationOptions

TaskCreationOptions

控制所创建的任务的行为的枚举值之一。

scheduler

TaskScheduler

用于计划所创建的任务的任务计划程序。

返回

Task<TResult>

已启动的任务。

例外

ObjectDisposedException

已释放创建 cancellationToken 的取消标记源。

ArgumentNullException

function 参数为 null。

- 或 -

scheduler 参数为 null。

ArgumentOutOfRangeException

creationOptions 参数指定的值无效。

注解

调用 StartNew 在功能上等效于使用其中一个 Task<TResult> 构造函数创建任务，然后调用 Start 方法来计划其执行。

但是，除非必须分开创建和计划， StartNew 否则建议使用简单性和性能的方法。

另请参阅

• 任务并行库 (TPL)
• 将 TPL 和其他异步模式结合使用