HostingEnvironment.StopListening Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
[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 Custom Event StopListening As EventHandler Public Shared Event StopListening As EventHandler Tipo de evento
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:
- O StopListening evento só está disponível para aplicativos configurados para usar o pipeline integrado do IIS.
- Os desenvolvedores não devem gerar erros de suas StopListening implementações; gerar erros terá resultados imprevisíveis.
- 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.
- O StopListening evento pode ser executado simultaneamente com outras IRegisteredObject notificações.
- 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.
- 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.
