WorkflowRuntimeService.Stop Metoda

Definicja

Przestrzeń nazw:

System.Workflow.Runtime.Hosting

Zestaw:

System.Workflow.Runtime.dll

Po zastąpieniu klasy pochodnej program zatrzymuje usługę i zmienia element 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

InvalidOperationException

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łoszenia odpowiedniego wyjątku, jeśli usługa zostanie 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 gwarancji, które w razie potrzeby 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 w celu obsługi innych usług, 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ć metodę OnStopped , aby wykonać wszelkie dodatkowe czynności wymagane do zakończenia zatrzymywania usługi po wystąpieniu WorkflowRuntime.Stopped zdarzenia.

Uwaga

Jeśli użytkownik WorkflowRuntimeService zostanie usunięty z aparatu środowiska uruchomieniowego przepływu pracy przez wywołanie RemoveService , gdy aparat środowiska uruchomieniowego przepływu pracy jest uruchomiony, aparat środowiska uruchomieniowego przepływu pracy wywoła Stop usługę. Jednak w takiej sytuacji OnStopped metoda nie zostanie wywołana dla Twojej usługi. W związku z tym usługa może wymagać wykonania dodatkowych funkcji zamykania, które zwykle będą wykonywane z OnStopped wewnątrz 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.