IAsyncInfo インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期アクションと操作をサポートします。 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
- 派生
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
API contract |
Windows.Foundation.FoundationContract (v1.0 で導入)
|
注釈
IAsyncInfo は、非同期メソッドのサポートに使用される 4 つのWindows ランタイム インターフェイスごとに継承されたインターフェイスです。 これらのボタンの役割は、次のとおりです。
- IAsyncAction
- IAsyncActionWithProgress<TProgress>
- IAsyncOperation<TResult>
- IAsyncOperationWithProgress<TResult,TProgress>
アプリ コードで非同期メソッドを使用する場合、通常、これらのインターフェイスは戻り値として表示されません。 これは、ほとんどの場合、インターフェイスを内部で処理する言語固有の待機可能な構文を使用するためです。 詳細については、「非同期プログラミング」、または非同期プログラミングを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() |
非同期操作を閉じます。 |
適用対象
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示