WorkflowInstance.Terminate(String) Metoda

Definicja

Przestrzeń nazw:

System.Workflow.Runtime

Zestaw:

System.Workflow.Runtime.dll

Przerywa wystąpienie przepływu pracy w sposób synchroniczny.

public:
 void Terminate(System::String ^ error);

public void Terminate (string error);

member this.Terminate : string -> unit

Public Sub Terminate (error As String)

Parametry

error

String

Opis przyczyny zakończenia wystąpienia przepływu pracy.

Wyjątki

InvalidOperationException

Aparat środowiska uruchomieniowego przepływu pracy nie jest uruchomiony.

Przykłady

W poniższym przykładzie kodu pokazano wywołanie metody Terminate w WorkflowInstance obiekcie .

// Create a workflow runtime
WorkflowRuntime workflowRuntime = new WorkflowRuntime();
// Create a workflow instance
WorkflowInstance workflowInstance = workflowRuntime.CreateWorkflow(typeof(Workflow1));
// Start the workflow
workflowInstance.Start();
// Terminate the workflow, passing in a message
workflowInstance.Terminate("Workflow manually terminated");

' Create a workflow runtime
Dim workflowRuntime As New WorkflowRuntime()
' Create a workflow instance
Dim workflowInstance As WorkflowInstance = workflowRuntime.CreateWorkflow(GetType(Workflow1))
' Start the workflow
workflowInstance.Start()
' Terminate the workflow, passing in a message
workflowInstance.Terminate("Workflow manually terminated")

Uwagi

Wystąpienie przepływu pracy jest przerywane w sposób synchroniczny. Host wywołuje wywołania Terminate w celu zakończenia wystąpienia przepływu pracy. Aparat środowiska uruchomieniowego przepływu pracy czyści wystąpienie przepływu pracy w pamięci i informuje usługę trwałości, że wystąpienie zostało wyczyszczone z pamięci. W przypadku elementu SqlWorkflowPersistenceServiceoznacza to, że wszystkie informacje o stanie dla tego wystąpienia przepływu pracy są usuwane z bazy danych po zakończeniu. Nie będzie można ponownie załadować wystąpienia przepływu pracy z wcześniej przechowywanego punktu trwałości.

Gdy wystąpienie przepływu pracy w pamięci zostanie wyczyszczone, a usługa trwałości zostanie poinformowana o zakończeniu, metoda zgłasza WorkflowTerminated zdarzenie i przekazuje reasonMessage właściwość elementu WorkflowTerminatedException zawartego w elemencie WorkflowTerminatedEventArgs.Terminate

Terminate jest inny niż Abort w tym, podczas gdy funkcja Terminate czyści wystąpienie przepływu pracy w pamięci i informuje usługę trwałości zakończenia, Abort po prostu czyści wystąpienie przepływu pracy w pamięci, które można następnie ponownie uruchomić z ostatniego punktu trwałości.