Partager via


Modèle de programmation asynchrone

Une opération asynchrone qui utilise le modèle de conception IAsyncResult est implémentée sous la forme de deux méthodes nommées BeginOperationName et EndOperationName qui commencent et terminent respectivement l’opération asynchrone OperationName. Par exemple, la classe FileStream fournit les méthodes BeginRead et EndRead pour lire les octets d’un fichier de façon asynchrone. Ces méthodes implémentent la version asynchrone de la méthode Read .

Notes

À compter du .NET Framework 4, la bibliothèque parallèle de tâches propose un nouveau modèle pour la programmation asynchrone et parallèle. Pour plus d’informations, consultez Task Parallel Library (TPL) et Task-based Asynchronous Pattern (TAP).

Après avoir appelé la méthode BeginOperationName, une application peut continuer à exécuter les instructions sur le thread appelant pendant que l’opération asynchrone s’exécute sur un autre thread. Pour chaque appel de la méthode BeginOperationName, l’application doit également appeler la méthode EndOperationName afin d’obtenir les résultats de l’opération.

Commencement d’une opération asynchrone

La méthode BeginOperationName commence l’opération asynchrone OperationName et retourne un objet qui implémente l’interface IAsyncResult. Les objetsIAsyncResult stockent des informations sur une opération asynchrone. Le tableau suivant affiche des informations sur une opération asynchrone.

Membre Description
AsyncState Objet spécifique à l'application facultatif qui contient les informations sur l'opération asynchrone.
AsyncWaitHandle WaitHandle qui peut être utilisé pour bloquer l’exécution de l’application jusqu’à ce que l’opération asynchrone se termine.
CompletedSynchronously Valeur qui indique si l’opération asynchrone s’est terminée sur le thread utilisé pour appeler la méthode BeginOperationName plutôt que sur un thread ThreadPool séparé.
IsCompleted Valeur qui indique si l’opération asynchrone est terminée.

Une méthode BeginOperationName accepte tous les paramètres déclarés dans la signature de la version synchrone de la méthode qui sont passés par valeur ou par référence. Aucun des paramètres out ne fait partie de la signature de méthode BeginOperationName. La signature de méthode BeginOperationName inclut également deux paramètres supplémentaires. Le premier définit un délégué AsyncCallback qui fait référence à une méthode appelée à la fin de l’opération asynchrone. L’appelant peut spécifier null (Nothing en Visual Basic) s’il ne veut pas qu’une méthode soit appelée à la fin de l’opération. Le deuxième paramètre supplémentaire est un objet défini par l’utilisateur. Cet objet peut être utilisé pour passer des informations d’état spécifiques à l’application à la méthode appelée à la fin de l’opération asynchrone. Si une méthode BeginOperationName accepte des paramètres supplémentaires correspondant à l’opération, tels qu’un tableau d’octets pour stocker des octets lus à partir d’un fichier, le AsyncCallback et l’objet d’état de l’application sont les derniers paramètres dans la signature de méthode BeginOperationName.

BeginOperationName retourne immédiatement le contrôle au thread appelant. Si la méthode BeginOperationName lève des exceptions, celles-ci le sont avant le lancement de l’opération asynchrone. Si la méthode BeginOperationName lève des exceptions, la méthode de rappel n’est pas appelée.

Fin d’une opération asynchrone

La méthode EndOperationName met fin à l’opération asynchrone OperationName. La valeur de retour de la méthode EndOperationName est de type identique à celui retourné par son équivalent synchrone et est spécifique à l’opération asynchrone. Par exemple, la méthode EndRead retourne le nombre d’octets lus à partir d’un FileStream et la méthode EndGetHostByName retourne un objet IPHostEntry qui contient des informations sur un ordinateur hôte. La méthode EndOperationName accepte tout paramètre out ou ref déclaré dans la signature de la version synchrone de la méthode. Outre les paramètres de la méthode synchrone, la méthode EndOperationName inclut également un paramètre IAsyncResult. Les appelants doivent passer l’instance retournée par l’appel correspondant à la méthode BeginOperationName.

Si l’opération asynchrone représentée par l’objet IAsyncResult n’est pas terminée quand la méthode EndOperationName est appelée, la méthode EndOperationName bloque le thread appelant jusqu’à la fin de l’opération asynchrone. Les exceptions levées par l’opération asynchrone sont levées à partir de la méthode EndOperationName. Les conséquences de plusieurs appels à la méthode EndOperationName avec le même IAsyncResult ne sont pas définies. De même, l’appel de la méthode EndOperationName avec un IAsyncResult qui n’a pas été retourné par la méthode Begin associée n’est pas non plus défini.

Notes

Pour l’un ou l’autre des scénarios indéfinis, les implémenteurs doivent envisager de lever InvalidOperationException.

Notes

Les implémenteurs de ce modèle de conception doivent informer l’appelant que l’opération asynchrone s’est terminée en attribuant à IsCompleted la valeur true, en appelant la méthode de rappel asynchrone (s’il en été spécifiée une) et en signalant AsyncWaitHandle.

Plusieurs options de conception s’offrent aux développeurs d’applications pour ce qui est de l’accès aux résultats de l’opération asynchrone. L’option appropriée varie selon que l’application peut exécuter ou non des instructions pendant que l’opération se termine. Si une application ne peut pas effectuer de tâches supplémentaires tant qu’elle n’a pas reçu les résultats de l’opération asynchrone, l’application doit être bloquée en attendant que les résultats soient disponibles. Pour la bloquer en attendant la fin de l’opération asynchrone, vous pouvez utiliser l’une des approches suivantes :

Les applications qui ne doivent pas être bloquées pendant que l’opération se termine peuvent utiliser l’une des approches suivantes :

Voir aussi