Język

WorkflowRuntimeService.Stop Metoda

Definicja

Po przesłonięciu w klasie pochodnej program zatrzymuje usługę i zmienia wartość State na 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 ()

Wyjątki

Runtime jest odwołaniem o wartości null (Nothing w Visual Basic).

— lub —

Usługa nie została jeszcze uruchomiona.

Uwagi

Stop jest wywoływany przez aparat środowiska uruchomieniowego przepływu pracy we wszystkich jego usługach, które pochodzą z WorkflowRuntimeService klasy, gdy StopRuntime jest wywoływana. Stop jest również wywoływany przez aparat środowiska uruchomieniowego przepływu pracy, gdy usługa aparatu środowiska uruchomieniowego przepływu pracy zostanie usunięta z aparatu środowiska uruchomieniowego przepływu pracy przez wywołanie metody RemoveService. Domyślna implementacja śledzi, Stop czy usługa została uruchomiona i używa tych informacji do zgłaszania odpowiedniego wyjątku, jeśli usługa została zatrzymana przed jej uruchomieniem.

Możesz zapewnić dodatkowe funkcje niezbędne do zatrzymania usługi przez aparat środowiska uruchomieniowego przepływu pracy, przesłaniając tę metodę. Nie ma żadnej gwarancji, o której, jeśli w ogóle, usługi zostaną zatrzymane lub uruchomione po Stop wywołaniu usługi. Aparat środowiska uruchomieniowego przepływu pracy zgłasza WorkflowRuntime.Stopped zdarzenie po wywołaniu Stop metody wszystkich usług aparatu środowiska uruchomieniowego przepływu pracy. Usługa może wymagać zachowania pewnych funkcji reszt, aby obsługiwać inne usługi, dopóki wszystkie usługi aparatu środowiska uruchomieniowego przepływu pracy nie będą miały metod zatrzymania wywoływanych przez aparat środowiska uruchomieniowego przepływu pracy. Jeśli usługa musi zachować taką funkcjonalność, możesz zastąpić OnStopped metodę , aby wykonać dowolną dodatkową akcję wymaganą do zakończenia zatrzymywania usługi po wystąpieniu WorkflowRuntime.Stopped zdarzenia.

Note

Jeśli aparat WorkflowRuntimeService środowiska uruchomieniowego przepływu pracy zostanie usunięty z aparatu środowiska uruchomieniowego przepływu pracy przez wywołanie RemoveService funkcji podczas działania aparatu środowiska uruchomieniowego przepływu pracy, aparat środowiska uruchomieniowego przepływu pracy wywoła Stop usługę. Jednak w takiej sytuacji OnStopped metoda nie zostanie wywołana dla usługi. W związku z tym usługa może wymagać wykonania wszelkich dodatkowych funkcji zamykania, które zwykle będą wykonywane OnStopped z poziomu Stop metody . Możesz przetestować IsStarted , aby określić, czy aparat środowiska uruchomieniowego przepływu pracy jest uruchomiony.

Stop powinien być wywoływany tylko przez aparat środowiska uruchomieniowego przepływu pracy.

Dotyczy