Partager via


IAsyncInfo Interface

Définition

Prend en charge les actions et opérations asynchrones. IAsyncInfo est une interface de base pour IAsyncAction , IAsyncActionWithProgressTProgress, IAsyncOperationTResult et IAsyncOperationWithProgressTResult,TProgress, chacun qui prend en charge les combinaisons de type de retour et de progression pour une méthode asynchrone.

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
Dérivé
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduit dans v1.0)

Remarques

IAsyncInfo est une interface héritée pour chacune des 4 interfaces Windows Runtime utilisées pour la prise en charge des méthodes asynchrones. Voici les éléments suivants :

Lorsque vous utilisez des méthodes asynchrones dans votre code d’application, vous ne voyez généralement aucune de ces interfaces comme valeur de retour. Cela est dû au fait que vous utilisez presque toujours la syntaxe awaitable spécifique au langage, qui gère les interfaces en interne. Pour plus d’informations, consultez de programmation asynchrone, ou l’un des guides spécifiques au langage pour la programmation asynchrone Windows Runtime (Appeler des API asynchrones en C# ou Visual Basic, C++, JavaScript).

Pour la plupart des codes d’application, il est rare d’utiliser IAsyncInfo comme API même si vous n’utilisez pas de syntaxe attendue. Chacun des langages a des points d’extension généralement plus faciles à utiliser que l’interface Windows RuntimeIAsyncInfo. JavaScript a la syntaxe puis/terminé. .NET a la méthode d’extension AsTask et une fois le IAsyncAction est converti en Tâche, il est plus facile d’annuler, d’obtenir une notification à la fin, et ainsi de suite. Pour C++/CX, vous pouvez encapsuler les appels à l’aide du runtime d’accès concurrentiel. En d’autres termes, IAsyncInfo est une infrastructure au niveau du runtime, que chacun des langages utilise comme infrastructure pour prendre en charge la syntaxe attendue de leur propre manière.

Si vous implémentez une action personnalisée ou une opération personnalisée (scénario avancé) n’implémentez pas IAsyncAction directement. Implémentez l’une des 4 interfaces précédemment répertoriées à la place.

Propriétés

ErrorCode

Obtient une chaîne qui décrit une condition d’erreur de l’opération asynchrone.

Id

Obtient le handle de l’opération asynchrone.

Status

Obtient une valeur qui indique l’état de l’opération asynchrone.

Méthodes

Cancel()

Annule l’opération asynchrone.

Close()

Ferme l’opération asynchrone.

S’applique à

Voir aussi