Export (0) Print
Expand All

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, see Correlated Local Service Sample.

this.taskCompleted2.CorrelationToken = correlationtoken1;

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

© 2014 Microsoft