HostingEnvironment.StopListening Událost

Definice

Obor názvů:

System.Web.Hosting

Sestavení:

System.Web.dll

[Podporováno pouze v rozhraní .NET Framework 4.5.1]

Nastane, když pracovní proces nebo fond aplikací přidružený k tomuto hostiteli přestal naslouchat novým požadavkům a nakonec se vypne.

public:
 static event EventHandler ^ StopListening;

public static event EventHandler StopListening;

member this.StopListening : EventHandler 

Public Shared Event StopListening As EventHandler 

Event Type

EventHandler

Poznámky

Když služba IIS vypíná fond aplikací a jeho přidružené pracovní procesy, například když fond aplikací dosáhne naplánovaného intervalu recyklace, služba IIS oznámí modulu runtime ASP.NET, že se aplikace vypíná a pracovní proces pro fond aplikací přestane naslouchat novým požadavkům. Aplikace, které používají dlouhotrvající požadavky, například aplikace SignalR , můžou události naslouchat StopListening a řádně vypnout dlouhotrvající operace, když služba IIS iniciovala vypnutí fondu aplikací a přidružených pracovních procesů.

Upozornění

Při implementaci události musí vývojář vzít v úvahu několik aspektů návrhu StopListening :

1. Událost StopListening je k dispozici pouze pro aplikace, které jsou nakonfigurované tak, aby používaly integrovaný kanál služby IIS.
2. Vývojáři nesmí vyvolat chyby ze svých StopListening implementací; vyvolání chyb bude mít nepředvídatelné výsledky.
3. Vzhledem k souběžné povaze operací v rámci ASP.NET není zaručeno, že ASP.NET zavolá StopListening událost, jakmile ji vývojář implementuje.
4. Událost se StopListening může spouštět souběžně s dalšími oznámeními IRegisteredObject .
5. Vývojáři si musí uvědomit, že ASP.NET můžou během spouštění události StopListening vypnout doménu aplikace, a navrhnout své implementace, aby tuto možnost zvládly.
6. StopListening obslužné rutiny událostí nesmí blokovat; blokování implementací způsobí zablokování a služba IIS ukončí pracovní proces po dosažení rychlého intervalu ochrany před selháním.