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)

來源:

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)

來源:

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)

來源:

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)

來源:

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)

來源:

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>)

來源:

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)

來源:

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)

來源:

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