SendAndReceiveReply Template Designer
[This is prerelease documentation and is subject to change in future releases. Blank topics are included as placeholders.]
The SendAndReceiveReply template is used to create a pair of pre-configured Send and ReceiveReply activities within a Sequence activity that are correlated as part of a request/response message exchange pattern on the client.
The SendAndReceiveReply Template
Adding SendAndReceiveReply template does three things besides creating the Send and ReceiveReply activities within a Sequence activity:
Configures the OperationName, ServiceContractName properties of the Send activity.
Binds the Request property of the ReceiveReply activity to the Send activity.
Creates a CorrelationHandle as a variable in the parent activity.
Using the SendAndReceiveReply Template Designer
The SendAndReceiveReply activity designer can be found in the Messaging category of the Toolbox, which is accessed by clicking the Toolbox tab on Workflow Designer (Alternatively, select Toolbar from the View menu, or CTRL+ALT+X.)
The SendAndReceiveReply activity designer can be dragged from the Toolbox and dropped on to the Workflow Designer surface wherever activities are usually placed. This creates a Send activity that can be configured with the Send activity designer and a correlated ReceiveReply that can be configured with the ReceiveReplyForSend designer.
For more information about using the Send designer to configure the Send activity, see the Send Activity Designer topic.
For more information about using the ReceiveReplyForSend designer to configure the ReceiveReply activity, see the following section.
Properties of ReceiveReply
The following table shows the ReceiveReply properties and describes how they are used in the designer. These properties can be edited in properties grid and some can be edited on Workflow Designerdesigner surface.
| Property Name | Required | Usage |
|---|---|---|
False |
The optional friendly name of the ReceiveReply activity. The default is ReceiveReplyForSend. Although the use of a non-default value for the friendly DisplayName is not strictly required, it is a best practice to use such a value. |
|
True |
Reference to the Send activity paired with this ReceiveReply activity. This property must not be null. Send and ReceiveReply activities are used together on the client to model a request/response messaging pattern. This property specifies which Send activity is paired. In the designer, you cannot edit this property because it is automatically bound to the Send activity from which you created the ReceiveReply activity. |
|
False |
Specifies the message or parameter content to receive. It can be either a ReceiveMessageContent activity or a ReceiveParametersContent activity. Edit this property by clicking the ellipse button beside the Content field in property grid or clicking the Define… button beside the Content label on the Receive activity designer surface. Both display the Content Definition dialog. For more information about how to use this box, see the Content Definition Dialog Box topic. |
|
False |
Specifies the collection of CorrelationInitializer objects that initialize multiple CorrelationHandle objects that configure this Receive activity within the workflow. Click the ellipsis button next to the CorrelationInitializers property in the properties grid to open the Add Correlation Initializers dialog box. For more information about using this box, see the Add CorrelationInitializers Dialog Box topic. |
|
False |
Specifies the action header of the message. If it is not explicitly set, its value defaults to: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name}.
|
See Also
Concepts
CorrelationScope Activity Designer
InitializeCorrelation Activity Designer
Receive Activity Designer
ReceiveAndSendReply Template Designer
Send Activity Designer
TransactedReceiveScope Activity Designer
Fill out a survey about this topic for Microsoft.
Build Date:
2012-08-02