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

定義

指定した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

IAsyncResultにラップされるTask

callback
AsyncCallback

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

state
Object

IAsyncResultに格納される状態。

返品

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

例外

tasknullです。

注釈

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

適用対象