HostingEnvironment.StopListening Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
[Pris en charge dans le .NET Framework 4.5.1 uniquement]
Se produit quand le processus de travail ou le pool d'applications associé à cet hôte a cessé d'écouter les nouvelles requêtes et finit par s'arrêter.
public:
static event EventHandler ^ StopListening;public static event EventHandler StopListening;member this.StopListening : EventHandler Public Shared Custom Event StopListening As EventHandler Public Shared Event StopListening As EventHandler Type d'événement
Remarques
Lorsqu’un pool d’applications et ses processus de travail associés sont arrêtés par IIS, par exemple lorsqu’un pool d’applications a atteint un intervalle de recyclage planifié, IIS avertit le ASP.NET runtime que l’application s’arrête et que le processus de travail du pool d’applications cesse d’écouter les nouvelles demandes. Les applications qui utilisent des requêtes de longue durée, par exemple les applications SignalR , peuvent écouter l’événement StopListening et arrêter correctement leurs opérations de longue durée lorsque IIS a lancé l’arrêt d’un pool d’applications et de ses processus worker associés.
Avertissement
Un développeur doit prendre en compte plusieurs considérations de conception lors de l’implémentation de l’événement StopListening :
- L’événement StopListening n’est disponible que pour les applications configurées pour utiliser le pipeline intégré IIS.
- Les développeurs ne doivent pas lever d’erreurs à partir de leurs StopListening implémentations ; les erreurs de levée auront des résultats imprévisibles.
- En raison de la nature simultanée des opérations au sein de ASP.NET, il n’est pas garanti que ASP.NET appellera un StopListening événement une fois qu’il aura été implémenté par un développeur.
- L’événement StopListening peut s’exécuter simultanément avec d’autres IRegisteredObject notifications.
- Les développeurs doivent savoir que ASP.NET peuvent arrêter le domaine d’application pendant l’exécution de leur StopListening événement et concevoir leurs implémentations pour gérer cette possibilité.
- StopListening les gestionnaires d’événements ne doivent pas bloquer ; les implémentations bloquantes entraînent des interblocages, et IIS met fin au processus de travail lorsque l’intervalle de protection contre les échecs rapides est atteint.
