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は、機能的には、いずれかのコンストラクターを使用してタスクを作成し、 メソッドをStartTask<TResult>呼び出して実行をスケジュールすることと同じです。

ただし、作成とスケジュールを分離する必要がない限り、 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は、機能的には、いずれかのコンストラクターを使用してタスクを作成し、 メソッドをStartTask<TResult>呼び出して実行をスケジュールすることと同じです。

ただし、作成とスケジュールを分離する必要がない限り、 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は、機能的には、いずれかのコンストラクターを使用してタスクを作成し、 メソッドをStartTask<TResult>呼び出して実行をスケジュールすることと同じです。

ただし、作成とスケジュールを分離する必要がない限り、 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は、機能的には、いずれかのコンストラクターを使用してタスクを作成し、 メソッドをStartTask<TResult>呼び出して実行をスケジュールすることと同じです。

ただし、作成とスケジュールを分離する必要がない限り、 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は、機能的には、いずれかのコンストラクターを使用してタスクを作成し、 メソッドをStartTask<TResult>呼び出して実行をスケジュールすることと同じです。

ただし、作成とスケジュールを分離する必要がない限り、 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は、機能的には、いずれかのコンストラクターを使用してタスクを作成し、 メソッドをStartTask<TResult>呼び出して実行をスケジュールすることと同じです。

ただし、作成とスケジュールを分離する必要がない限り、 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は、機能的には、いずれかのコンストラクターを使用してタスクを作成し、 メソッドをStartTask<TResult>呼び出して実行をスケジュールすることと同じです。

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

こちらもご覧ください

• タスク並列ライブラリ (TPL)
• TPL と他の非同期パターンの使用