TaskFactory<TResult>.StartNew メソッド

定義

名前空間:: System.Threading.Tasks

アセンブリ:: mscorlib.dll, System.Threading.Tasks.dll

アセンブリ:: mscorlib.dll

アセンブリ:: System.Threading.Tasks.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

タスクを作成して開始します。

オーバーロード

名前	説明
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)

タスクを作成して開始します。

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 はシンプルさとパフォーマンスの両方に対して推奨されるアプローチです。

こちらもご覧ください

適用対象

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

タスクを作成して開始します。

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

作成されたタスクの動作を制御する列挙値の 1 つ。

返品

Task<TResult>

開始されたタスク。

例外

ArgumentNullException

function引数はnull。

ArgumentOutOfRangeException

creationOptions パラメーターは無効な値を指定します。

注釈

ただし、作成とスケジュールを分離する必要がない限り、 StartNew はシンプルさとパフォーマンスの両方に対して推奨されるアプローチです。

こちらもご覧ください

適用対象

StartNew(Func<TResult>, TaskCreationOptions)

タスクを作成して開始します。

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

作成されたタスクの動作を制御する列挙値の 1 つ。

返品

Task<TResult>

開始 Task<TResult>。

例外

ArgumentNullException

function引数はnull。

ArgumentOutOfRangeException

creationOptions パラメーターは無効な値を指定します。

注釈

ただし、作成とスケジュールを分離する必要がない限り、 StartNew はシンプルさとパフォーマンスの両方に対して推奨されるアプローチです。

こちらもご覧ください

適用対象

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

タスクを作成して開始します。

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

作成されたタスクの動作を制御する列挙値の 1 つ。

scheduler: TaskScheduler

作成されたタスクのスケジュール設定に使用されるタスクスケジューラ。

返品

Task<TResult>

開始されたタスク。

例外

ObjectDisposedException

cancellationTokenを作成したキャンセルトークンソースは既に破棄されています。

ArgumentNullException

function引数はnull。

-または-

scheduler引数はnull。

ArgumentOutOfRangeException

creationOptions パラメーターは無効な値を指定します。

注釈

ただし、作成とスケジュールを分離する必要がない限り、 StartNew はシンプルさとパフォーマンスの両方に対して推奨されるアプローチです。

こちらもご覧ください

適用対象

StartNew(Func<Object,TResult>, Object)

タスクを作成して開始します。

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 はシンプルさとパフォーマンスの両方に対して推奨されるアプローチです。

こちらもご覧ください

適用対象

StartNew(Func<TResult>)

タスクを作成して開始します。

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 はシンプルさとパフォーマンスの両方に対して推奨されるアプローチです。

こちらもご覧ください

適用対象

StartNew(Func<TResult>, CancellationToken)

タスクを作成して開始します。

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 はシンプルさとパフォーマンスの両方に対して推奨されるアプローチです。

こちらもご覧ください

適用対象

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

タスクを作成して開始します。

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)