.NET Framework Class Library
WorkflowInstance..::.Suspend Method

Suspends the workflow instance.

Namespace:  System.Workflow.Runtime
Assembly:  System.Workflow.Runtime (in System.Workflow.Runtime.dll)
Syntax

Visual Basic (Declaration)
Public Sub Suspend ( _
    error As String _
)
Visual Basic (Usage)
Dim instance As WorkflowInstance
Dim error As String

instance.Suspend(error)
C#
public void Suspend(
    string error
)
Visual C++
public:
void Suspend(
    String^ error
)
JScript
public function Suspend(
    error : String
)

Parameters

error
Type: System..::.String
A description of the reason for suspending the workflow instance.
Exceptions

ExceptionCondition
InvalidOperationException

The workflow runtime engine is not running.

Remarks

The workflow instance is suspended in a synchronous manner. If the workflow instance is already suspended, no action is taken; otherwise, the workflow runtime engine suspends the workflow instance, raises the WorkflowSuspended event and passes reason in a WorkflowSuspendedEventArgs.

NoteNote:

Suspend does not unload the workflow instance.

Examples

The following code example demonstrates calling Suspend on a WorkflowInstance object.

Visual Basic
' 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()
' Suspend the workflow, passing in a message
workflowInstance.Suspend("Workflow manually suspended")
C#
// Create a workflow runtime
WorkflowRuntime workflowRuntime = new WorkflowRuntime();
// Create a workflow instance
WorkflowInstance workflowInstance = workflowRuntime.CreateWorkflow(typeof(Workflow1));
// Start the workflow
workflowInstance.Start();
// Suspend the workflow, passing in a message
workflowInstance.Suspend("Workflow manually suspended");
.NET Framework Security

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0
See Also

Reference

Tags :


Page view tracker