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 .

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.

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.

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 :

• Appelez la méthode EndOperationName à partir du thread principal de l’application, ce qui bloque l’exécution de l’application jusqu’à ce que l’opération soit terminée. Pour obtenir un exemple illustrant cette technique, consultez Blocage de l'exécution d'applications en mettant fin à une opération asynchrone.

• Utilisez AsyncWaitHandle pour bloquer l’exécution de l’application en attendant qu’une ou plusieurs opérations soient terminées. Pour obtenir un exemple illustrant cette technique, consultez Blocking Application Execution Using an AsyncWaitHandle.

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

• Interrogez l’état d’achèvement de l’opération en vérifiant périodiquement la propriété IsCompleted et en appelant la méthode EndOperationName quand l’opération est terminée. Pour obtenir un exemple illustrant cette technique, consultez Polling for the Status of an Asynchronous Operation.

• Utilisez un délégué AsyncCallback pour spécifier la méthode à appeler quand l’opération se termine. Pour obtenir un exemple illustrant cette technique, consultez Using an AsyncCallback Delegate to End an Asynchronous Operation.

Voir aussi

• Modèle asynchrone basé sur les événements (EAP)
• Appel de méthodes synchrones de façon asynchrone
• Utilisation d'un délégué AsyncCallback et objet d'état