WorkflowRuntimeService.Stop Метод

Определение

Пространство имен:

System.Workflow.Runtime.Hosting

Сборка:

System.Workflow.Runtime.dll

При переопределении в производном классе останавливает службу и изменяет State на Stopping.

protected public:
 virtual void Stop();

protected internal virtual void Stop ();

abstract member Stop : unit -> unit
override this.Stop : unit -> unit

Protected Friend Overridable Sub Stop ()

Исключения

InvalidOperationException

Параметр Runtime является неопределенной ссылкой (Nothing в Visual Basic).

-или-

Служба еще не запущена.

Комментарии

Stop вызывается подсистемой среды выполнения рабочих процессов во всех службах, производных от класса WorkflowRuntimeService, при вызове StopRuntime. Stop — этот метод вызывается также подсистемой среды выполнения рабочих процессов, когда служба подсистемы среды выполнения рабочих процессов удаляется из этой подсистемы путем вызова метода RemoveService. Реализация по умолчанию Stop отслеживает запуск службы и использует эти сведения для вызова подходящего исключения, если служба остановлена перед ее запуском.

Можно обеспечить дополнительные функциональные возможности, необходимые для остановки службы подсистемой среды выполнения рабочих процессов, путем переопределения этого метода. Невозможно гарантировать, какие службы (если таковые имеются) будут остановлены или будут выполняться при вызове Stop в службе. Подсистема среды выполнения рабочих процессов вызывает событие WorkflowRuntime.Stopped после вызова метода Stop всех служб подсистемы среды выполнения рабочих процессов. Службе может потребоваться сохранить прежние функциональные возможности для обеспечения поддержки других служб, пока методы остановки всех служб подсистемы среды выполнения рабочих процессов не будут вызваны подсистемой среды выполнения рабочих процессов. Если службе необходимо сохранить такие функциональные возможности, можно переопределить метод OnStopped, чтобы выполнить дополнительные действия, необходимые для завершения остановки службы при вызове события WorkflowRuntime.Stopped.

Примечание

При удалении класса WorkflowRuntimeService из подсистемы среды выполнения рабочих процессов путем вызова RemoveService при выполнении подсистемы среды выполнения рабочих процессов, подсистема среды выполнения рабочих процессов вызовет Stop в службе. Однако в такой ситуации метод OnStopped не будет вызван для службы. Поэтому службе может быть необходимо выполнить дополнительные функциональные возможности завершения работы, которые обычно должны выполняться в OnStopped из метода Stop. Можно проверить IsStarted, чтобы определить, выполняется ли подсистема среды выполнения рабочих процессов.

Класс Stop должен вызываться только подсистемой среды выполнения рабочих процессов.