TaskToAsyncResult.Begin(Task, AsyncCallback, Object) メソッド

定義

名前空間:

System.Threading.Tasks

アセンブリ:

System.Runtime.dll

ソース:

TaskToAsyncResult.cs

指定した Taskから新しい IAsyncResult を作成します。必要に応じて、タスクの完了時に をcallback呼び出します。

public:
 static IAsyncResult ^ Begin(System::Threading::Tasks::Task ^ task, AsyncCallback ^ callback, System::Object ^ state);

public static IAsyncResult Begin (System.Threading.Tasks.Task task, AsyncCallback? callback, object? state);

static member Begin : System.Threading.Tasks.Task * AsyncCallback * obj -> IAsyncResult

Public Shared Function Begin (task As Task, callback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

task

Task

TaskでIAsyncResultラップされる 。

callback

AsyncCallback

の完了時 taskに呼び出されるコールバック。 の場合 null、コールバックは呼び出されません。

state

Object

に格納 IAsyncResultされる状態。

戻り値

IAsyncResult

IAsyncResultタスクの非同期操作を表す 。 このインスタンスは、呼び出されると に callback 渡されます。

例外

ArgumentNullException

task は null です。

注釈

メソッドまたは End<TResult>(IAsyncResult) メソッドとEnd(IAsyncResult)組み合わせて、このメソッドを使用して Begin/End パターン (非同期プログラミング モデル パターンまたは APM とも呼ばれます) を実装できます。 新しいコードでは、このパターンを公開しないことをお勧めします。のメソッド TaskToAsyncResult は、このような Begin/End メソッドを実装するためにのみ使用されます。たとえば、基底クラスがパターンの仮想メソッドを提供する場合や、既に公開されていて互換性のために残る必要がある場合などです。 これらのメソッドを使用すると、 を介して Taskすべてのコア非同期ロジックを実装し、その機能に関する Begin/End メソッドを簡単に実装できます。