This topic has not yet been rated - Rate this topic

WorkflowInstance.ApplyWorkflowChanges Method

.NET Framework 4

Other Versions

Applies changes to the workflow instance specified by the WorkflowChanges object.

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

Syntax

C++

Copy

public void ApplyWorkflowChanges(
	WorkflowChanges workflowChanges
)

Parameters

workflowChanges: Type: System.Workflow.ComponentModel.WorkflowChanges
A WorkflowChanges specifying dynamic updates for the workflow instance.

Exceptions

Exception	Condition
InvalidOperationException	The workflow runtime engine is not running.

Remarks

If the workflow instance is not already suspended, the workflow runtime engine temporarily suspends the instance before applying the changes.

Examples

The following example demonstrates calling ApplyWorkflowChanges to a WorkflowInstance object. This example is from the Ordering State Machine SDK sample, from the Mainform.cs file. For more information, see the Ordering State Machine Sample.

Copy


// Apply the changes to the workflow instance
try
{
    instance.ApplyWorkflowChanges(changes);
}
catch (WorkflowValidationFailedException)
{
    // New state has already been added
    MessageBox.Show("On Hold state has already been added to this workflow.");
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

WorkflowInstance Class

System.Workflow.Runtime Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ