HostingEnvironment.StopListening Événement

Définition

Espace de noms:

System.Web.Hosting

Assembly:

System.Web.dll

[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 Event StopListening As EventHandler 

Type d'événement

EventHandler

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 :

1. L’événement StopListening n’est disponible que pour les applications configurées pour utiliser le pipeline intégré IIS.
2. 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.
3. 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.
4. L’événement StopListening peut s’exécuter simultanément avec d’autres IRegisteredObject notifications.
5. 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é.
6. 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.