IAsyncInfo 接口

定义

支持异步操作和操作。 IAsyncInfo 是 IAsyncActionIAsyncActionWithProgress<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 运行时接口中的每一个的继承接口。 它们是:

在应用代码中使用异步方法时,通常看不到其中任何接口作为返回值。 这是因为你几乎总是使用特定于语言的可等待语法,该语法在内部处理接口。 有关详细信息,请参阅异步编程,或Windows 运行时异步编程 (调用 C# 或 Visual BasicC++JavaScript) 异步 API 的特定于语言的指南之一。

对于大多数应用代码,即使不使用可等待的语法,也很少将 IAsyncInfo 用作 API。 每种语言都具有通常比 Windows RuntimeIAsyncInfo 接口更易于使用的扩展点。 JavaScript 具有 then/done 语法。 .NET 具有 AsTask 扩展方法,并且 IAsyncAction 转换为 Task 后,可以更轻松地取消、在完成时获取通知等。 对于 C++/CX,可以使用 并发运行时包装调用。 换句话说,IAsyncInfo 是运行时级基础结构,每种语言都将其用作框架,以自己的方式支持可等待的语法。

如果要在高级方案中实现自定义操作或自定义操作 () 请不要直接实现 IAsyncAction 。 改为实现前面列出的 4 个接口之一。

属性

ErrorCode

获取描述异步操作的错误条件的字符串。

Id

获取异步操作的句柄。

Status

获取一个值,该值指示异步操作的状态。

方法

Cancel()

取消异步操作。

Close()

关闭异步操作。

适用于

另请参阅