HostingEnvironment.StopListening Ereignis

  • Referenz

Definition

Namespace:
System.Web.Hosting
Assembly:
System.Web.dll

[Wird nur in .NET Framework 4.5.1 unterstützt]

Tritt auf, wenn der Arbeitsprozess oder diesem Host zugeordnete Anwendungspool nicht mehr auf neue Anforderungen lauscht und schließlich beendet wird.

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

Ereignistyp

EventHandler

Hinweise

Wenn ein Anwendungspool und die zugehörigen Arbeitsprozesse von IIS heruntergefahren werden, z. B. wenn ein Anwendungspool ein geplantes Wiederverwendungsintervall erreicht hat, benachrichtigt IIS die ASP.NET Runtime, dass die Anwendung heruntergefahren wird und der Arbeitsprozess für den Anwendungspool nicht mehr auf neue Anforderungen lauscht. Anwendungen, die anforderungen mit langer Ausführungsdauer verwenden, z. B. SignalR-Anwendungen , können auf das StopListening Ereignis lauschen und ihre zeitintensiven Vorgänge ordnungsgemäß herunterfahren, wenn IIS das Herunterfahren eines Anwendungspools und der zugehörigen Arbeitsprozesse initiiert hat.

Warnung

Es gibt mehrere Entwurfsüberlegungen, die ein Entwickler bei der Implementierung des Ereignisses StopListening berücksichtigen muss:

  1. Das StopListening Ereignis ist nur für Anwendungen verfügbar, die für die Verwendung der integrierten IIS-Pipeline konfiguriert sind.
  2. Entwickler dürfen keine Fehler aus ihren StopListening Implementierungen auslösen. Das Auslösen von Fehlern führt zu unvorhersehbaren Ergebnissen.
  3. Aufgrund der gleichzeitigen Art von Vorgängen innerhalb ASP.NET gibt es keine Garantie, dass ASP.NET ein StopListening Ereignis aufruft, sobald es von einem Entwickler implementiert wurde.
  4. Das StopListening Ereignis kann gleichzeitig mit anderen IRegisteredObject Benachrichtigungen ausgeführt werden.
  5. Entwickler müssen sich bewusst sein, dass ASP.NET die Anwendungsdomäne möglicherweise herunterfahren, während ihr StopListening Ereignis ausgeführt wird, und ihre Implementierungen so entwerfen, dass diese Möglichkeit behandelt wird.
  6. StopListening -Ereignishandler dürfen nicht blockieren. blockierende Implementierungen führen zu Deadlocks, und IIS beendet den Arbeitsprozess, wenn das schnelle Fehlerschutzintervall erreicht ist.

Gilt für: