HostingEnvironment.StopListening Evento

Definição

Namespace:

System.Web.Hosting

Assembly:

System.Web.dll

[Suporte somente no .NET Framework 4.5.1]

Ocorre quando o processo de trabalho ou pool de aplicativos associado a este host parou de escutar novas solicitações e acabará sendo desligado.

public:
 static event EventHandler ^ StopListening;

public static event EventHandler StopListening;

member this.StopListening : EventHandler 

Public Shared Event StopListening As EventHandler 

Tipo de evento

EventHandler

Comentários

Quando um pool de aplicativos e seus processos de trabalho associados estão sendo desligados pelo IIS, por exemplo, quando um pool de aplicativos atinge um intervalo de reciclagem agendado, o IIS notifica a ASP.NET runtime de que o aplicativo está sendo desligado e o processo de trabalho do pool de aplicativos para de escutar novas solicitações. Aplicativos que usam solicitações de execução longa, por exemplo, aplicativos SignalR , podem escutar o StopListening evento e encerrar normalmente suas operações de longa execução quando o IIS tiver iniciado o desligamento de um pool de aplicativos e seus processos de trabalho associados.

Aviso

Há várias considerações de design que um desenvolvedor deve considerar ao implementar o StopListening evento:

1. O StopListening evento só está disponível para aplicativos configurados para usar o pipeline integrado do IIS.
2. Os desenvolvedores não devem gerar erros de suas StopListening implementações; gerar erros terá resultados imprevisíveis.
3. Devido à natureza simultânea das operações em ASP.NET, não há garantia de que ASP.NET chamará um StopListening evento depois que ele for implementado por um desenvolvedor.
4. O StopListening evento pode ser executado simultaneamente com outras IRegisteredObject notificações.
5. Os desenvolvedores precisam estar cientes de que ASP.NET pode desligar o domínio do aplicativo enquanto o StopListening evento está em execução e projetar suas implementações para lidar com essa possibilidade.
6. StopListening manipuladores de eventos não devem bloquear; as implementações de bloqueio resultarão em deadlocks e o IIS encerrará o processo de trabalho quando o intervalo de proteção contra falhas rápida for atingido.