HostingEnvironment.StopListening Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
[Поддерживается только в .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
Тип события
Комментарии
Когда iis завершают работу пула приложений и связанных с ним рабочих процессов, например когда пул приложений достиг запланированного интервала перезапуска, СЛУЖБЫ IIS уведомляют среду выполнения ASP.NET о завершении работы приложения и о том, что рабочий процесс для пула приложений перестает прослушивать новые запросы. Приложения, использующие длительные запросы, например приложения SignalR , могут прослушивать StopListening событие и корректно завершать длительные операции, когда IIS инициировали завершение работы пула приложений и связанных с ним рабочих процессов.
Предупреждение
Существует несколько аспектов проектирования, которые разработчик должен учитывать при реализации StopListening события:
- Событие StopListening доступно только для приложений, настроенных для использования интегрированного конвейера IIS.
- Разработчики не должны создавать ошибки из своих StopListening реализаций; создание ошибок приведет к непредсказуемым результатам.
- Из-за параллельного характера операций в ASP.NET нет никакой гарантии, что ASP.NET вызовет StopListening событие после его реализации разработчиком.
- Событие StopListening может выполняться одновременно с другими IRegisteredObject уведомлениями.
- Разработчики должны знать, что ASP.NET могут завершить работу домена приложения во время выполнения события StopListening , и разработать свои реализации для обработки этой возможности.
- StopListening обработчики событий не должны блокироваться; Блокирование реализаций приведет к взаимоблокировке, а службы IIS завершают рабочий процесс при достижении интервала быстрого отказа защиты.