|
1 | 1 | ---
|
2 | 2 | title: "Add CorrelationInitializers Dialog Box | Microsoft Docs"
|
3 |
| -ms.custom: "" |
4 | 3 | ms.date: "11/04/2016"
|
5 |
| -ms.reviewer: "" |
6 |
| -ms.suite: "" |
7 |
| -ms.tgt_pltfrm: "" |
8 | 4 | ms.topic: "reference"
|
9 | 5 | f1_keywords:
|
10 | 6 | - "AddCorrelationInitializers.UI"
|
11 | 7 | ms.assetid: c0517467-d54a-4ee6-aef0-c19b96b6f395
|
12 |
| -caps.latest.revision: 5 |
13 |
| -author: "ErikRe" |
14 |
| -ms.author: "erikre" |
15 |
| -manager: "erikre" |
| 8 | +author: gewarren |
| 9 | +ms.author: gewarren |
| 10 | +manager: ghogen |
16 | 11 | ms.workload:
|
17 | 12 | - "multiple"
|
18 | 13 | ---
|
19 | 14 | # Add CorrelationInitializers Dialog Box
|
20 |
| -The **Add Correlation Initializers** dialog box is used in [!INCLUDE[wfd1](../workflow-designer/includes/wfd1_md.md)] to configure the **CorrelationInitializers** properties of the <xref:System.ServiceModel.Activities.Send>, <xref:System.ServiceModel.Activities.Receive>, <xref:System.ServiceModel.Activities.SendReply>, and <xref:System.ServiceModel.Activities.ReceiveReply> activities. [!INCLUDE[crabout](../test/includes/crabout_md.md)] the activity designers that use this box, see the [Send](../workflow-designer/send-activity-designer.md), [Receive](../workflow-designer/receive-activity-designer.md), [ReceiveAndSendReply](../workflow-designer/receiveandsendreply-template-designer.md), and [SendAndReceiveReply](../workflow-designer/sendandreceivereply-template-designer.md) topics. |
21 |
| - |
22 |
| - 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. |
23 |
| - |
24 |
| - The following table describes the user interface (UI) elements of the **Add Correlation Initializers** dialog box. |
25 |
| - |
26 |
| -|UI Element|Description| |
27 |
| -|----------------|-----------------| |
28 |
| -|**Add Initializer**|Click the **Add initialize** box to add an additional initializer to the collection.| |
29 |
| -|**Correlation Type**|Specifies the type of correlation initializer. There are four types to choose from:<br /><br /> 1. A callback correlation initializer to specify a <xref:System.ServiceModel.Activities.CallbackCorrelationInitializer>.<br />2. A context correlation initializer to specify a <xref:System.ServiceModel.Activities.CorrelationInitializer>.<br />3. A request-reply correlation initializer to specify a <xref:System.ServiceModel.Activities.RequestReplyCorrelationInitializer>.<br />4. A query correlation initializer to specify a <xref:System.ServiceModel.Activities.QueryCorrelationInitializer>.<br /><br /> To edit the **CorrelationType**<br /><br /> 1. Tab to the specific row in the **Add Initializer** DataGrid.<br />2. Press Ctrl+Tab to set focus to **CorrelationTypeComboBox**<br />3. Press Alt+Down to pop up the **ComboBox** and edit it.| |
30 |
| -|**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 <xref:System.ServiceModel.Activities.QueryCorrelationInitializer> types.| |
31 |
| - |
32 |
| -## To launch the Add Correlation Initializers dialog box |
33 |
| - 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. |
34 |
| - |
35 |
| - The **Receive** activity designer can be dragged from the **Toolbox** and dropped on to the [!INCLUDE[wfd2](../workflow-designer/includes/wfd2_md.md)] surface wherever activities are usually placed. This creates a <xref:System.ServiceModel.Activities.Receive> activity with a default <xref:System.Activities.Activity.DisplayName%2A> 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. |
36 |
| - |
37 |
| -## See Also |
38 |
| - [Add Correlation Dialog Box](http://msdn.microsoft.com/en-us/9e41a149-e8ab-41b1-8886-ea06a63041b6) |
39 |
| - [Initialize Correlation Dialog Box](../workflow-designer/initialize-correlation-dialog-box.md) |
| 15 | +The **Add Correlation Initializers** dialog box is used in Windows Workflow Designer to configure the **CorrelationInitializers** properties of the <xref:System.ServiceModel.Activities.Send>, <xref:System.ServiceModel.Activities.Receive>, <xref:System.ServiceModel.Activities.SendReply>, and <xref:System.ServiceModel.Activities.ReceiveReply> activities. For more information about the activity designers that use this box, see the [Send](../workflow-designer/send-activity-designer.md), [Receive](../workflow-designer/receive-activity-designer.md), [ReceiveAndSendReply](../workflow-designer/receiveandsendreply-template-designer.md), and [SendAndReceiveReply](../workflow-designer/sendandreceivereply-template-designer.md) topics. |
| 16 | + |
| 17 | + 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. |
| 18 | + |
| 19 | + The following table describes the user interface (UI) elements of the **Add Correlation Initializers** dialog box. |
| 20 | + |
| 21 | +|UI Element|Description| |
| 22 | +|----------------|-----------------| |
| 23 | +|**Add Initializer**|Click the **Add initialize** box to add an additional initializer to the collection.| |
| 24 | +|**Correlation Type**|Specifies the type of correlation initializer. There are four types to choose from:<br /><br /> 1. A callback correlation initializer to specify a <xref:System.ServiceModel.Activities.CallbackCorrelationInitializer>.<br />2. A context correlation initializer to specify a <xref:System.ServiceModel.Activities.CorrelationInitializer>.<br />3. A request-reply correlation initializer to specify a <xref:System.ServiceModel.Activities.RequestReplyCorrelationInitializer>.<br />4. A query correlation initializer to specify a <xref:System.ServiceModel.Activities.QueryCorrelationInitializer>.<br /><br /> To edit the **CorrelationType**<br /><br /> 1. Tab to the specific row in the **Add Initializer** DataGrid.<br />2. Press Ctrl+Tab to set focus to **CorrelationTypeComboBox**<br />3. Press Alt+Down to pop up the **ComboBox** and edit it.| |
| 25 | +|**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 <xref:System.ServiceModel.Activities.QueryCorrelationInitializer> types.| |
| 26 | + |
| 27 | +## To launch the Add Correlation Initializers dialog box |
| 28 | + 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. |
| 29 | + |
| 30 | + The **Receive** activity designer can be dragged from the **Toolbox** and dropped on to the [!INCLUDE[wfd2](../workflow-designer/includes/wfd2_md.md)] surface wherever activities are usually placed. This creates a <xref:System.ServiceModel.Activities.Receive> activity with a default <xref:System.Activities.Activity.DisplayName%2A> 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. |
| 31 | + |
| 32 | +## See also |
| 33 | + |
| 34 | +- [Add Correlation Dialog Box](http://msdn.microsoft.com/en-us/9e41a149-e8ab-41b1-8886-ea06a63041b6) |
| 35 | +- [Initialize Correlation Dialog Box](../workflow-designer/initialize-correlation-dialog-box.md) |
0 commit comments