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 ランタイム非同期プログラミングに関する言語固有のガイドの 1 つ (C# または Visual Basic、C++、JavaScript) を参照してください。

ほとんどのアプリ コードでは、待機可能な構文を使用しない場合でも、API として IAsyncInfo を使用することは一般的ではありません。 各言語には、Windows RuntimeIAsyncInfo インターフェイスよりも一般的に使いやすい拡張ポイントがあります。 JavaScript には、構文 があります。 .NET には AsTask 拡張メソッドがあり、IAsyncAction を Taskに変換すると、キャンセルや完了時の通知の取得などが簡単になります。 C++/CX の場合は、コンカレンシー ランタイムを使用して呼び出しをラップできます。 言い換えると、IAsyncInfo はランタイム レベルのインフラストラクチャであり、各言語は独自の方法で待機可能な構文をサポートするためのフレームワークとして使用されます。

カスタム アクションまたはカスタム操作 (高度なシナリオ) を実装する場合は、IAsyncAction 直接実装しないでください。 代わりに、前述の 4 つのインターフェイスのいずれかを実装します。

プロパティ

ErrorCode

非同期操作のエラー条件を記述する文字列を取得します。
Id

非同期操作のハンドルを取得します。
Status

非同期操作の状態を示す値を取得します。

メソッド

Cancel()

非同期操作を取り消します。
Close()

非同期操作を閉じます。

適用対象

こちらもご覧ください