IAsyncInfo Interface

  • Référence

Définition

Espace de noms:
Windows.Foundation
Modifier

Prend en charge les actions et opérations asynchrones. IAsyncInfo est une interface de base pour IAsyncAction, IAsyncActionWithProgress<TProgress>, IAsyncOperation<TResult> et IAsyncOperationWithProgress<TResult,TProgress>, chacune d’elles prennent en charge des 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
ContractVersionAttribute GuidAttribute

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. Ces règles sont les suivantes :

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

Pour la plupart du code d’application, il est rare d’utiliser IAsyncInfo en tant qu’API, même si vous n’utilisez pas de syntaxe awaitable. Chacun des langages a des points d’extension qui sont généralement plus faciles à utiliser que l’interface Windows RuntimeIAsyncInfo. JavaScript a la syntaxe then/done . .NET a la méthode d’extension AsTask , et une fois que IAsyncAction est converti en tâche, il est plus facile d’annuler, d’obtenir une notification à l’achèvement, etc. 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 awaitable à sa façon.

Si vous implémentez une action personnalisée ou une opération personnalisée (scénario avancé), n’implémentez pas directement IAsyncAction . 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 le status de l’opération asynchrone.

Méthodes

Cancel()

Annule l’opération asynchrone.
Close()

Ferme l’opération asynchrone.

S’applique à

Voir aussi