CorrelationScope Activity Designer
[This is prerelease documentation and is subject to change in future releases. Blank topics are included as placeholders.]
The CorrelationScope activity designer is used to create and configure a CorrelationScope activity that provides implicit management of child messaging activities using a CorrelationHandle object.
The CorrelationScope Activity
The CorrelatesWith property specifies the CorrelationHandle used to manage child messaging activities. The Send and Receive activities contained in the Body are configured to use the CorrelatesWith property of the containing CorrelationScope activity to perform correlation.
Using the CorrelationScope Activity Designer
The CorrelationScope activity designer can be found in the Messaging category of the Toolbox, which is accessed by clicking the Toolbox tab on the left side of the Workflow Designer (Alternatively, select Toolbar from the View menu, or CTRL+ALT+X.)
The CorrelationScope activity designer can be dragged from the Toolbox and dropped on to the Workflow Designer surface. This creates a CorrelationScope activity with a default DisplayName of CorrelationScope. The DisplayName can be edited in the header of the CorrelationScope activity designer or in the DisplayName box of the Properties window.
To specify the CorrelationHandle used by child messaging activities, click the ellipse button beside the CorrelatesWith field in Properties window to display the Expression Editor dialog box. This property can also be set on the activity designer surface.
The activities scoped within the correlation are specified by dropping their designers within the Body box within the CorrelationScope designer.
The CorrelationScope Properties
The following table shows the CorrelationScope properties and describes how they are used in the designer. These properties can be edited either in Properties window or on Workflow Designer designer surface, and often in both.
| Property Name | Required | Usage |
|---|---|---|
False |
The optional friendly name of the InitializeCorrelation activity. |
|
False |
Specifies the CorrelationHandle used to manage child messaging activities. If you do not set this property, CorrelationScope creates an implicit CorrelationHandle automatically. |
|
False |
Specifies the activities within the scope of the correlation. |
See Also
Concepts
InitializeCorrelation Activity Designer
Receive Activity Designer
ReceiveAndSendReply Template Designer
Send Activity Designer
SendAndReceiveReply Template Designer
TransactedReceiveScope Activity Designer
Fill out a survey about this topic for Microsoft.
Build Date:
2012-08-02