IAsyncInfo 介面

  • 參考

定義

命名空間:
Windows.Foundation
編輯

支援非同步動作和作業。 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
衍生
屬性
ContractVersionAttribute GuidAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.FoundationContract (已於 v1.0 引進)

備註

IAsyncInfo 是 4 個Windows 執行階段介面的繼承介面，用於非同步方法支援。 這些節點為：

當您在應用程式程式碼中使用非同步方法時，通常不會看到任何這些介面做為傳回值。 這是因為您幾乎一律會使用語言特定的可等候語法，以在內部處理介面。 如需詳細資訊，請參閱非同步程式設計或其中一個語言特定的指南，以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()

關閉非同步作業。

適用於

另請參閱