Udostępnij za pośrednictwem


HostingEnvironment.StopListening Zdarzenie

Definicja

[Obsługiwane tylko w programie .NET Framework 4.5.1]

Występuje, gdy proces roboczy lub pula aplikacji skojarzona z tym hostem przestała nasłuchiwać nowych żądań i ostatecznie zostanie zamknięta.

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 

Typ zdarzenia

Uwagi

Gdy pula aplikacji i skojarzone z nią procesy robocze są zamykane przez usługi IIS, na przykład gdy pula aplikacji osiągnęła zaplanowany interwał odtwarzania, usługi IIS powiadamiają środowisko uruchomieniowe ASP.NET, że aplikacja jest zamykana, a proces roboczy puli aplikacji przestaje nasłuchiwać nowych żądań. Aplikacje korzystające z długotrwałych żądań, na przykład aplikacji SignalR , mogą nasłuchiwać zdarzenia StopListening i bezpiecznie zamykać długotrwałe operacje, gdy usługi IIS zainicjowały zamknięcie puli aplikacji i skojarzonych z nią procesów roboczych.

Ostrzeżenie

Istnieje kilka zagadnień projektowych, które deweloper musi wziąć pod uwagę podczas implementowania StopListening zdarzenia:

  1. Zdarzenie StopListening jest dostępne tylko dla aplikacji skonfigurowanych do korzystania ze zintegrowanego potoku usług IIS.
  2. Deweloperzy nie mogą zgłaszać błędów ze swoich StopListening implementacji; zgłaszanie błędów będzie miało nieprzewidywalne wyniki.
  3. Ze względu na współbieżny charakter operacji w ASP.NET nie ma gwarancji, że ASP.NET wywoła StopListening zdarzenie po jego zaimplementowaniu przez dewelopera.
  4. Zdarzenie StopListening może być wykonywane współbieżnie z innymi IRegisteredObject powiadomieniami.
  5. Deweloperzy muszą pamiętać, że ASP.NET może zamknąć domenę aplikacji, podczas gdy ich StopListening zdarzenie jest wykonywane i projektuje ich implementacje w celu obsługi tej możliwości.
  6. StopListening Programy obsługi zdarzeń nie mogą blokować; blokowanie implementacji spowoduje zakleszczenia, a usługi IIS zakończą proces roboczy po osiągnięciu interwału szybkiej ochrony po awarii.

Dotyczy