TaskToAsyncResult.Begin(Task, AsyncCallback, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した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 にも渡されます。
例外
task は nullです。
注釈
このメソッドは、 End(IAsyncResult) または End<TResult>(IAsyncResult) メソッドと組み合わせて、Begin/End パターン (非同期プログラミング モデル パターンまたは APM とも呼ばれます) を実装するために使用できます。 新しいコードでは、このパターンを公開しないことをお勧めします。 TaskToAsyncResult のメソッドは、基底クラスがパターンの仮想メソッドを提供する場合や、既に公開されていて互換性のために残る必要がある場合など、このような Begin/End メソッドを実装する場合にのみ役立ちます。 これらのメソッドを使用すると、 Taskを介してすべてのコア非同期ロジックを実装し、その機能に関する Begin/End メソッドを簡単に実装できます。