IAsyncInfo 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
支持异步操作和操作。 IAsyncInfo 是 IAsyncAction、IAsyncActionWithProgress<TProgress>、IAsyncOperation TResult > 和 IAsyncOperationWithProgress<TResult,TProgress> 的基本接口,每个接口都支持异步方法的返回类型和进度的组合。 <
public interface class IAsyncInfo
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
struct IAsyncInfo
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
public interface IAsyncInfo
Public Interface IAsyncInfo
- 派生
- 属性
Windows 要求
设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
API contract |
Windows.Foundation.FoundationContract (在 v1.0 中引入)
|
注解
IAsyncInfo 是用于异步方法支持的 4 个Windows 运行时接口中的每一个的继承接口。 它们是:
- IAsyncAction
- IAsyncActionWithProgress<TProgress>
- IAsyncOperation<TResult>
- IAsyncOperationWithProgress<TResult,TProgress>
在应用代码中使用异步方法时,通常看不到其中任何接口作为返回值。 这是因为你几乎总是使用特定于语言的可等待语法,该语法在内部处理接口。 有关详细信息,请参阅异步编程,或Windows 运行时异步编程 (调用 C# 或 Visual Basic、C++、JavaScript) 异步 API 的特定于语言的指南之一。
对于大多数应用代码,即使不使用可等待的语法,也很少将 IAsyncInfo 用作 API。 每种语言都具有通常比 Windows RuntimeIAsyncInfo 接口更易于使用的扩展点。 JavaScript 具有 then/done 语法。 .NET 具有 AsTask 扩展方法,并且 IAsyncAction 转换为 Task 后,可以更轻松地取消、在完成时获取通知等。 对于 C++/CX,可以使用 并发运行时包装调用。 换句话说,IAsyncInfo 是运行时级基础结构,每种语言都将其用作框架,以自己的方式支持可等待的语法。
如果要在高级方案中实现自定义操作或自定义操作 () 请不要直接实现 IAsyncAction 。 改为实现前面列出的 4 个接口之一。
属性
ErrorCode |
获取描述异步操作的错误条件的字符串。 |
Id |
获取异步操作的句柄。 |
Status |
获取一个值,该值指示异步操作的状态。 |
方法
Cancel() |
取消异步操作。 |
Close() |
关闭异步操作。 |
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈