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

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

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

プロパティ

ErrorCode

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

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

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

メソッド

Cancel()

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

非同期操作を閉じます。

適用対象

こちらもご覧ください