TaskToAsyncResult.Begin(Task, AsyncCallback, Object) 方法

定義

命名空間:

System.Threading.Tasks

組件:

System.Runtime.dll

來源:

TaskToAsyncResult.cs

從指定的 建立新的 IAsyncResult ，選擇性地在工作完成時叫用 callback 。 Task

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 s 實作所有核心非同步邏輯，然後輕鬆地針對該功能實作 Begin/End 方法。