HostingEnvironment.StopListening HostingEnvironment.StopListening HostingEnvironment.StopListening HostingEnvironment.StopListening Event

Definition

[Wird nur im .NET Framework 4.5.1 unterstützt][Supported in the .NET Framework 4.5.1 only]

Tritt auf, wenn der Arbeitsprozess oder diesem Host zugeordnete Anwendungspool nicht mehr auf neue Anforderungen lauscht und schließlich beendet wird.Occurs when the worker process or application pool associated with this host has stopped listening for new requests and will eventually shut down.

public:
 static event EventHandler ^ StopListening;
public static event EventHandler StopListening;
member this.StopListening : EventHandler 
Public Shared Event StopListening As EventHandler 

Hinweise

Wenn ein Anwendungs Pool und die zugehörigen Arbeitsprozesse von IIS heruntergefahren werden, z. b. Wenn ein Anwendungs Pool ein geplantes Wiederverwendungs Intervall erreicht hat, benachrichtigt IIS die ASP.NET-Laufzeit, dass die Anwendung heruntergefahren wird, und der Arbeitsprozess für der Anwendungs Pool beendet die Überwachung auf neue Anforderungen.When an application pool and its associated worker processes are being shut down by IIS, for example when an application pool has reached a scheduled recycle interval, IIS notifies the ASP.NET runtime that the application is shutting down and the worker process for the application pool stops listening for new requests. Anwendungen, die lange Ausführungsanforderungen verwenden (z. b. signalr -Anwendungen), StopListening können auf das Ereignis lauschen und Ihre Vorgänge mit langer Ausführungszeit ordnungsgemäß beenden, wenn IIS das Herunterfahren eines Anwendungs Pools initiiert hat und dessen zugeordnete Arbeitsprozesse.Applications that use long-running requests, for example SignalR applications, can listen for the StopListening event and gracefully shut down their long-running operations when IIS has initiated the shutdown of an application pool and its associated worker processes.

Warnung

Es gibt mehrere Entwurfs Überlegungen, die ein Entwickler bei der Implementierung StopListening des Ereignisses berücksichtigen muss:There are several design considerations that a developer must consider when implementing the StopListening event:

  1. Das StopListening Ereignis ist nur für Anwendungen verfügbar, die für die Verwendung der integrierten IIS-Pipeline konfiguriert sind.The StopListening event is only available for applications that are configured to use the IIS integrated pipeline.
  2. Entwickler dürfen keine Fehler aus Ihren StopListening Implementierungen auslösen. das Auslösen von Fehlern führt zu unvorhersehbaren Ergebnissen.Developers must not throw errors from their StopListening implementations; throwing errors will have unpredictable results.
  3. Aufgrund der gleichzeitigen Funktionsweise von Vorgängen in ASP.net gibt es keine Garantie dafür, dass ASP.net StopListening ein-Ereignis aufruft, sobald es von einem Entwickler implementiert wurde.Due to the concurrent nature of operations within ASP.NET, there is no guarantee that ASP.NET will call a StopListening event once it has been implemented by a developer.
  4. Das StopListening Ereignis kann gleichzeitig mit anderen IRegisteredObject Benachrichtigungen ausgeführt werden.The StopListening event can execute concurrently with other IRegisteredObject notifications.
  5. Entwickler müssen sich bewusst sein, dass ASP.net die Anwendungsdomäne Herunterfahren kann, StopListening während Ihr Ereignis ausgeführt wird, und ihre Implementierungen so entwerfen, dass Sie diese Möglichkeit bewältigen können.Developers need to be aware that ASP.NET may shut down the application domain while their StopListening event is executing and design their implementations to handle that possibility.
  6. StopListeningEreignishandler dürfen nicht blockiert werden. blockierende Implementierungen führen zu Deadlocks, und der Arbeitsprozess wird von IIS beendet, wenn das Intervall für den schnellen Ausfallschutz erreicht wird.StopListening event handlers must not block; blocking implementations will result in deadlocks, and IIS will terminate the worker process when the rapid fail protection interval is reached.

Gilt für: