Share via

Add CorrelationInitializers Dialog Box

  • Article

The Add Correlation Initializers dialog box is used in Windows Workflow Designer to configure the CorrelationInitializers properties of the Send, Receive, SendReply, and ReceiveReply activities. For more information about the activity designers that use this box, see the Send Activity Designer, Receive Activity Designer, ReceiveAndSendReply Template Designer, and SendAndReceiveReply Template Designer topics.

The correlation initializers in the collection specified with this dialog box can initialize query-based, context, callback context, or request-reply correlations between the messaging activities.

The following table describes the user interface (UI) elements of the Add Correlation Initializers dialog box.

UI Element Description

Add Initializer

Click the Add initialize box to add an additional initializer to the collection.

Correlation Type

Specifies the type of correlation initializer. There are four types to choose from:

  1. A callback correlation initializer to specify a CallbackCorrelationInitializer.

  2. A context correlation initializer to specify a CorrelationInitializer.

  3. A request-reply correlation initializer to specify a RequestReplyCorrelationInitializer.

  4. A query correlation initializer to specify a QueryCorrelationInitializer.

To edit the CorrelationType

  1. Tab to the specific row in the Add Initializer DataGrid.

  2. Press Ctrl+Tab to set focus to CorrelationTypeComboBox

  3. Press Alt+Down to pop up the ComboBox and edit it.

XPath Queries

A key/value pair that contains the queries used to extract correlation data from incoming and outgoing messages. This list is only valid when using QueryCorrelationInitializer types.

To launch the Add Correlation Initializers dialog box

The Add Correlation Initializers dialog box is used by the Send, Receive, ReceiveAndSendReply, and SendAndReceiveReply designers. Accessing them is similar in each case and the case that involves the Receive designer is use here to illustrate the procedure.

The Receive activity designer can be dragged from the Toolbox and dropped on to the Workflow Designer surface wherever activities are usually placed. This creates a Receive activity with a default DisplayName of Receive. Select the Receive activity designer and click the ellipsis button next to the (Collection) text for the CorrelationInitializers property in the property grid for the Add Correlation Initializers dialog box to appear.

See Also

Concepts

Initialize Correlation Dialog Box

Other Resources

Add Correlation Dialog Box