IAsyncActionWithProgress<TProgress> Interface

Définition

public interface class IAsyncActionWithProgress : IAsyncInfo

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(527282776, 59395, 18593, 149, 70, 235, 115, 83, 57, 136, 132)]
template <typename TProgress>
struct IAsyncActionWithProgress : IAsyncInfo

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(527282776, 59395, 18593, 149, 70, 235, 115, 83, 57, 136, 132)]
public interface IAsyncActionWithProgress<TProgress> : IAsyncInfo

Public Interface IAsyncActionWithProgress(Of TProgress)
Implements IAsyncInfo

Paramètres de type

Attributs

ContractVersionAttribute GuidAttribute

Implémente

IAsyncInfo

Configuration requise pour Windows

Exemples

Pour obtenir un exemple de code C++/WinRT illustrant la façon de gérer l’événement Progress , consultez Types délégués pour les actions et opérations asynchrones.

Remarques

IAsyncActionWithProgress TProgress<est le type de retour pour toutes les méthodes asynchrones> Windows Runtime qui ne communiquent pas d’objet de résultat, mais qui permettent à une application de case activée la progression de l’action. Il n’y a pas autant de méthodes qui utilisent IAsyncAction. IAsyncAction Les API ne rapportent pas de progression et n’ont pas de résultat.

Lorsque vous utilisez des méthodes qui retournent IAsyncActionWithProgress TProgress<> dans le code de votre application, vous n’accédez généralement pas directement à la valeur de retour IAsyncAction. En effet, vous utilisez presque toujours la syntaxe awaitable propre au langage. Dans ce cas, la valeur de retour apparente de la méthode est void. 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).

Il n’est pas courant d’utiliser IAsyncActionWithProgress<> directement même si vous n’utilisez pas de syntaxe d’attente spécifique au langage. Chacun des langages a des points d’extension qui sont généralement plus faciles à utiliser que l’interface Windows Runtime. JavaScript a WinJS.Promise, et la syntaxe then/done with onProgress . .NET possède les méthodes d’extension AsTask. Une fois que le TProgress IAsyncActionWithProgress<> est converti en tâche, il est plus facile d’annuler, d’obtenir une notification à l’achèvement, d’utiliser IProgress<T>, etc. Pour C++/CX, vous pouvez encapsuler les appels à l’aide du runtime d’accès concurrentiel (et utiliser create_task). En d’autres termes, IAsyncActionWithProgress TProgress<peut être considéré comme une infrastructure au niveau de l’exécution, que chacun des langages> utilise comme infrastructure pour prendre en charge la syntaxe attendue ou les modèles de programmation asynchrone à sa manière.

Plus précisément, si vous souhaitez gérer la progression dans le code .NET, utilisez la signature AsTask qui, dans l’utilisation d’une extension, a un seul paramètre de référence IProgress . (Dans cette utilisation, l’unité de progression est déjà contrainte et correspond à la méthode IAsyncActionWithProgress que vous utilisez.) Fournissez un objet qui implémente IProgress, et votre implémentation de méthode Report est appelée chaque fois que la méthode Windows Runtime signale une notification de progression.

Pour surveiller la progression de l’action (si vous n’utilisez pas les techniques spécifiques au langage décrites ci-dessus), définissez la propriété Progress , en lui fournissant le nom d’une méthode qui implémente le délégué AsyncActionProgressHandler<TProgress> .

Fonctions d’extension C++/WinRT

void get() const;

Attend de façon synchrone que l’action se termine. Lève une exception correspondante si l’action est annulée ou entre dans un état d’erreur. Vous ne devez pas l’appeler à partir d’un appartement à thread unique. Pour plus d’informations et pour obtenir des exemples de code montrant comment appeler get, consultez Écrire une coroutine.

AsyncStatus wait_for(TimeSpan const& timeout) const;

Attend de manière synchrone la fin de l’action ou le délai d’expiration spécifié. Retourne l’état de IAsyncActionWithProgress ou AsyncStatus ::Started si le délai d’expiration s’est écoulé. Si l’action n’a pas expiré, appelez GetResults pour obtenir les résultats de l’action. Pour plus d’informations et pour obtenir des exemples de code montrant comment appeler wait_for, consultez Délais d’expiration asynchrones simplifiés.

Héritage de l'interface

IAsyncActionWithProgress<TProgress hérite d’IAsyncInfo>. Les types qui implémentent IAsyncActionWithProgress TProgress<> implémentent également les membres d’interface d’IAsyncInfo :

• Cancel , méthode
• Close , méthode
• Propriété ErrorCode
• Id , propriété
• Propriété Status

Remarques aux implémenteurs

Comme pour appeler les méthodes existantes, il existe des méthodes spécifiques au langage pour définir des méthodes asynchrones qui n’utilisent pas directement IAsyncActionWithProgress<TProgress> . Si vous écrivez du code à l’aide de .NET, votre méthode peut retourner une tâche. Pour C++/CX, vous pouvez utiliser le runtime d’accès concurrentiel. Toutefois, si vous définissez un composant, vous pouvez utiliser tâche de/tâche en interne, mais vous devez retourner l’une des interfaces Windows Runtime pour vos méthodes publiques. Les types de prise en charge asynchrone spécifiques au langage (et de nombreux autres types spécifiques à la langue que vous pouvez utiliser conventionnellement dans le code) ne peuvent pas être utilisés pour la surface d’exposition publique d’un composant Windows Runtime.

Propriétés

Méthodes

S’applique à

Voir aussi

• IAsyncInfo
• IAsyncAction