通过

IAsyncInfo 接口

  • 参考

定义

命名空间:
Windows.Foundation
编辑

支持异步操作和操作。 IAsyncInfo 是一个基接口，用于 IAsyncAction、IAsyncActionWithProgressTProgress、IAsyncOperation TResult 和 IAsyncOperationWithProgressTResult、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
派生
属性
ContractVersionAttribute GuidAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.FoundationContract (在 v1.0 中引入)

注解

IAsyncInfo 是用于异步方法支持的每个 4 个 Windows 运行时接口的继承接口。 以下是：

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

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

如果要实现自定义操作或自定义操作（高级方案），则不会直接实现 IAsyncAction。 改为实现前面列出的 4 个接口之一。

属性

ErrorCode

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

获取异步操作的句柄。
Status

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

方法

Cancel()

取消异步操作。
Close()

关闭异步操作。

适用于

另请参阅