HostingEnvironment.StopListening イベント

定義

名前空間:

System.Web.Hosting

アセンブリ:

System.Web.dll

[.NET Framework 4.5.1 のみでサポート]

発生した時、ワーカーの処理か、このホストに関連付けられているアプリケーション プールが新しい要求のリッスンを停止して、最終的にシャット ダウンされるときに発生します。

public:
 static event EventHandler ^ StopListening;

public static event EventHandler StopListening;

member this.StopListening : EventHandler 

Public Shared Event StopListening As EventHandler 

イベントの種類

EventHandler

注釈

アプリケーション プールとそれに関連付けられているワーカー プロセスが IIS によってシャットダウンされている場合 (たとえば、アプリケーション プールがスケジュールされたリサイクル間隔に達した場合)、IIS はアプリケーションがシャットダウンしていることを ASP.NET ランタイムに通知し、アプリケーション プールのワーカー プロセスが新しい要求のリッスンを停止します。 実行時間の長い要求 ( SignalR アプリケーションなど) を使用するアプリケーションは、IIS がアプリケーション プールとそれに関連付けられているワーカー プロセスのシャットダウンを開始したときに、イベントをリッスン StopListening し、実行時間の長い操作を正常にシャットダウンできます。

警告

イベントの実装時に開発者が考慮する必要がある設計上の StopListening 考慮事項がいくつかあります。

1. この StopListening イベントは、IIS 統合パイプラインを使用するように構成されているアプリケーションでのみ使用できます。
2. 開発者は実装からエラーを StopListening スローしないでください。エラーをスローすると、予測できない結果になります。
3. ASP.NET 内の操作が同時に行われるので、開発者が実装した後に ASP.NET がイベントを StopListening 呼び出す保証はありません。
4. イベントは StopListening 、他 IRegisteredObject の通知と同時に実行できます。
5. 開発者は、ASP.NET イベントの実行中 StopListening にアプリケーション ドメインをシャットダウンし、その可能性を処理するように実装を設計する可能性があることに注意する必要があります。
6. StopListening イベント ハンドラーはブロックできません。ブロック実装ではデッドロックが発生し、急速な障害保護間隔に達すると IIS によってワーカー プロセスが終了します。