WorkflowInstance.Terminate(String) Metoda

Definice

Obor názvů:

System.Workflow.Runtime

Sestavení:

System.Workflow.Runtime.dll

Ukončí instanci pracovního postupu synchronním způsobem.

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

Popis důvodu ukončení instance pracovního postupu.

Výjimky

InvalidOperationException

Modul runtime pracovního postupu není spuštěný.

Příklady

Následující příklad kódu ukazuje volání Terminate na objektu WorkflowInstance .

// 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")

Poznámky

Instance pracovního postupu je ukončena synchronním způsobem. Hostitel zavolá Terminate k ukončení instance pracovního postupu. Modul runtime pracovního postupu vymaže instanci pracovního postupu v paměti a informuje službu trvalosti, že instance byla vymazána z paměti. U objektu SqlWorkflowPersistenceServiceto znamená, že všechny informace o stavu pro danou instanci pracovního postupu se po ukončení odstraní z databáze. Instanci pracovního postupu nebudete moct znovu načíst z dříve uloženého bodu trvalosti.

Po vymazání instance pracovního postupu v paměti a služba trvalosti je informována o ukončení, metoda vyvolá WorkflowTerminated událost a předá reasonMessage vlastnost WorkflowTerminatedException obsažené v objektu WorkflowTerminatedEventArgs.Terminate

Terminate se liší od Abort toho, že zatímco Terminate vymaže instanci pracovního postupu v paměti a informuje službu trvalosti o ukončení, Abort jednoduše vymaže instanci pracovního postupu v paměti, kterou pak lze restartovat od posledního bodu trvalosti.