InitializeCorrelation 活动设计器

**“InitializeCorrelation”**活动设计器用于创建和配置 InitializeCorrelation 活动,该活动用于在发送或接收消息之前在这些消息之间建立相关。

InitializeCorrelation 活动

InitializeCorrelation 活动用于在不发送或接收消息的情况下初始化相关。通常,相关是在发送或接收消息时初始化的。如果必须在发送或接收消息前建立相关,请使用 InitializeCorrelation 来初始化该相关。

使用 InitializeCorrelation 活动设计器

**“InitializeCorrelation”活动设计器可在“工具箱”“消息传递”类别中找到,“工具箱”可通过单击 工作流设计器 上的“工具箱”选项卡(或者,从“视图”菜单中选择“工具栏”**或按 Ctrl+Alt+X)来访问。

可以将**“InitializeCorrelation”活动设计器从“工具箱”拖放到 工作流设计器 图面上。这将创建具有 InitializeCorrelation 的默认 DisplayNameInitializeCorrelation 活动。可以在“InitializeCorrelation”活动设计器的标头中或在“属性”窗口的“DisplayName”**框中编辑 DisplayName

可以在**“InitializeCorrelation”活动设计器图面上的“属性”窗口的“相关”**字段中指定 CorrelationHandle

单击**“属性”窗口中“CorrelationData”字段旁的椭圆形按钮或“InitializeCorrelation”活动设计器图面上的“查看…”提示文本将显示“初始化相关”**对话框,在该对话框中可指定相关句柄和用于初始化该相关的键值对。有关使用此对话框的更多信息,请参见“类型集合编辑器”对话框主题。

InitializeCorrelation 属性

下表列出 InitializeCorrelation 属性并说明如何在设计器中使用它们。这些属性可以在**“属性”**窗口或 工作流设计器 图面中进行编辑。

属性名 必需 用法

DisplayName

False

InitializeCorrelation 活动的友好名称。默认值为 InitializeCorrelation。

虽然对友好 DisplayName 使用非默认值不是绝对必需的,但最好使用非默认值。

Correlation

False

用于关联相关中的工作流活动的 CorrelationHandle

CorrelationData

False

将消息与工作流实例相关联的相关数据的字典。

使用“初始化相关”对话框可以配置 CorrelationData。有关使用此对话框的更多信息,请参见“类型集合编辑器”对话框主题。

另请参见

概念

CorrelationScope 活动设计器
Receive 活动设计器
ReceiveAndSendReply 模板设计器
Send 活动设计器
SendAndReceiveReply 模板设计器
TransactedReceiveScope 活动设计器