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
要 Task 包裹在 IAsyncResult.
- callback
- AsyncCallback
完成後 task將啟動的呼喚。 若 null,則不會觸發回調。
- state
- Object
要儲存在 IAsyncResult的狀態。
傳回
an IAsyncResult 代表任務的非同步操作。 這個實例也會傳遞到 callback 被召喚時。
例外狀況
task 是 null。
備註
End(IAsyncResult)結合 or End<TResult>(IAsyncResult) 方法,此方法可用來實作開始/結束模式(亦稱為非同步程式設計模型模式,APM)。 建議不要在新程式碼中揭露此模式;這些 TaskToAsyncResult 方法僅用於在必須暴露此類開始/結束方法時協助實作,例如基底類別提供模式的虛擬方法,或當這些方法已暴露且必須保持相容性時。 這些方法使得透過 S 實作所有核心非同步邏輯 Task,並輕鬆地圍繞該功能實作開始/結束方法。