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 的详细信息,请参阅 Task 的补充 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 |
提供对用于创建和配置 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 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈