Task 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示非同步作業。
public ref class Task : IAsyncResult
public ref class Task : IAsyncResult, IDisposable
public class Task : IAsyncResult
public class Task : IAsyncResult, IDisposable
type Task = class
interface IAsyncResult
type Task = class
interface IAsyncResult
interface IDisposable
Public Class Task
Implements IAsyncResult
Public Class Task
Implements IAsyncResult, IDisposable
- 繼承
-
Task
- 衍生
- 實作
備註
如需此 API 的詳細資訊,請參閱 工作補充 API 備註。
建構函式
Task(Action) |
使用指定的動作,初始化新的 Task。 |
Task(Action, CancellationToken) |
使用指定的動作和 Task,初始化新的 CancellationToken。 |
Task(Action, CancellationToken, TaskCreationOptions) |
使用指定的動作和建立選項,初始化新的 Task。 |
Task(Action, TaskCreationOptions) |
使用指定的動作和建立選項,初始化新的 Task。 |
Task(Action<Object>, Object) |
使用指定的動作和狀態,初始化新的 Task。 |
Task(Action<Object>, Object, CancellationToken) |
使用指定的動作、狀態和 CancellationToken,初始化新的 Task 。 |
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions) |
使用指定的動作、狀態和選項,初始化新的 Task。 |
Task(Action<Object>, Object, TaskCreationOptions) |
使用指定的動作、狀態和選項,初始化新的 Task。 |
屬性
AsyncState |
取得建立 Task 時提供的狀態物件,如果未提供則為 null。 |
CompletedTask |
取得已成功完成的工作。 |
CreationOptions |
取得用來建立這個工作的 TaskCreationOptions。 |
CurrentId |
傳回目前執行之 Task 的唯一 ID。 |
Exception |
取得導致 AggregateException 不當結束的 Task。 如果 Task 順利完成,或未擲回任何例外狀況,則這會傳回 |
Factory |
提供 Factory 方法的存取,這些 Factory 方法用於建立及設定 Task 和 Task<TResult> 執行個體。 |
Id |
取得這個 Task 執行個體的 ID。 |
IsCanceled |
取得這個 Task 執行個體是否因取消才完成執行。 |
IsCompleted |
取得值,這個值表示工作是否已經完成。 |
IsCompletedSuccessfully |
取得工作是否執行到完成。 |
IsFaulted |
取得 Task 是否因未處理的例外狀況才完成。 |
Status |
取得這個工作的 TaskStatus。 |
方法
明確介面實作
IAsyncResult.AsyncWaitHandle |
取得 WaitHandle,這個項目可用來等候工作完成。 |
IAsyncResult.CompletedSynchronously |
取得作業是否已同步完成的指示。 |
擴充方法
AsyncWait<TException>(Task) |
表示非同步作業。 |
AwaitWithTimeout(Task, TimeSpan) |
表示非同步作業。 |
ToApm(Task, AsyncCallback, Object) |
表示非同步作業。 |
ToApmEnd(IAsyncResult) |
表示非同步作業。 |
ToApmEnd<TResult>(IAsyncResult) |
表示非同步作業。 |
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String) |
表示非同步作業。 |
WaitForCompletion(Task) |
表示非同步作業。 |
WaitForCompletionNoSpin(Task) |
表示非同步作業。 |
WaitForCompletionNoSpin(Task, TimeSpan) |
表示非同步作業。 |
WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken) |
表示非同步作業。 |
DispatcherOperationWait(Task) |
無限期等候基礎 DispatcherOperation 完成。 |
DispatcherOperationWait(Task, TimeSpan) |
在指定的時間長度中等候,等候基礎 DispatcherOperation 完成。 |
IsDispatcherOperationTask(Task) |
傳回值,表示這個 Task 是否與 DispatcherOperation 關聯。 |
AsAsyncAction(Task) |
傳回代表已開始的動作的 Windows 執行階段非同步動作。 |
適用於
執行緒安全性
除了 以外的Dispose()所有成員Task都是安全線程,而且可以從多個線程同時使用。
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應