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 Custom Event StopListening As EventHandler 
Public Shared Event StopListening As EventHandler

Тип события

EventHandler

Комментарии

Когда iis завершают работу пула приложений и связанных с ним рабочих процессов, например когда пул приложений достиг запланированного интервала перезапуска, СЛУЖБЫ IIS уведомляют среду выполнения ASP.NET о завершении работы приложения и о том, что рабочий процесс для пула приложений перестает прослушивать новые запросы. Приложения, использующие длительные запросы, например приложения SignalR , могут прослушивать StopListening событие и корректно завершать длительные операции, когда IIS инициировали завершение работы пула приложений и связанных с ним рабочих процессов.

Предупреждение

Существует несколько аспектов проектирования, которые разработчик должен учитывать при реализации StopListening события:

  1. Событие StopListening доступно только для приложений, настроенных для использования интегрированного конвейера IIS.
  2. Разработчики не должны создавать ошибки из своих StopListening реализаций; создание ошибок приведет к непредсказуемым результатам.
  3. Из-за параллельного характера операций в ASP.NET нет никакой гарантии, что ASP.NET вызовет StopListening событие после его реализации разработчиком.
  4. Событие StopListening может выполняться одновременно с другими IRegisteredObject уведомлениями.
  5. Разработчики должны знать, что ASP.NET могут завершить работу домена приложения во время выполнения события StopListening , и разработать свои реализации для обработки этой возможности.
  6. StopListening обработчики событий не должны блокироваться; Блокирование реализаций приведет к взаимоблокировке, а службы IIS завершают рабочий процесс при достижении интервала быстрого отказа защиты.

Применяется к