HandleExternalEventActivity.CorrelationToken Property


Gets or sets the binding to a CorrelationToken.

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

public virtual CorrelationToken CorrelationToken { get; set; }

Property Value

Type: System.Workflow.Runtime.CorrelationToken

This property is used to correlate an event to the correct IEventActivity-inherited activity based on the payload of the event. For example, when a single workflow instance is listening for multiple instances of the same event at the same time, the CorrelationToken property is used to route the event to the proper activity in that workflow instance.

This correlation should not be confused with correlating an event to the correct workflow instance. The correlation to the correct workflow instance is done by sending the event to an explicit workflow instance and using the InstanceId property to properly identify the correct workflow instance.

For an example of correlation, see the Correlated Local Service Sample.

The following example shows how to access the CorrelationToken property of a HandleExternalEventActivity. This example is from the Correlated Local Service SDK sample, from the CorrelatedLocalServiceWorkflow.designer.cs file. For more information, seeCorrelated Local Service Sample.

this.taskCompleted2.CorrelationToken = correlationtoken1;

.NET Framework
Available since 3.0
Return to top