要求/応答

このトピックの内容は、Windows Workflow Foundation 4 に該当します。

要求/応答の相関関係は、ReceiveReply と Send のペアと使用すると、ワークフロー サービスに双方向の操作を実装でき、SendReply と Receive のペアと使用すると、別の Web サービスの双方向の操作を呼び出すことができます。WCF サービスの双方向の操作を呼び出す場合、このサービスには、従来の命令型のコード ベースの Windows Communication Foundation (WCF) サービスを使用することも、ワークフロー サービスを使用することもできます。要求/応答の相関関係を使用するには、BasicHttpBinding などの双方向のバインドを使用する必要があります。双方向の操作を呼び出す場合と実装する場合では、相関関係の初期化に同様の手順が使用されます。これらの手順については、このセクションで説明します。

Receive/SendReply による双方向の操作での相関関係の使用

Receive/SendReply のペアは、ワークフロー サービスに双方向の操作を実装するために使用されます。ランタイムは、要求/応答の相関関係を使用して、応答が正しい呼び出し元にディスパッチされるようにします。ワークフローが WorkflowServiceHost を使用してホストされている場合、つまり、ワークフロー サービスの場合は、既定の相関関係の初期化で十分です。このシナリオでは、Receive/SendReply のペアがワークフローによって使用されます。特定の相関関係の構成は不要です。

Receive StartOrder = new Receive
{
    CanCreateInstance = true,
    ServiceContractName = OrderContractName,
    OperationName = "StartOrder"
};

SendReply ReplyToStartOrder = new SendReply
{
    Request = StartOrder,
    Content = … // Contains the return value, if any.
};

// Construct a workflow using StartOrder and ReplyToStartOrder.

要求/応答の相関関係の明示的な初期化

他の双方向の操作が並列実行される場合、相関関係を明示的に構成する必要があります。それには、CorrelationHandle と RequestReplyCorrelationInitializer を指定するか、CorrelationScope 内に Receive/SendReply を設定します。この例では、要求/応答の相関関係が Receive/SendReply のペアを使用して構成されています。

Variable<CorrelationHandle> RRHandle = new Variable<CorrelationHandle>();

Receive StartOrder = new Receive
{
    CanCreateInstance = true,
    ServiceContractName = OrderContractName,
    OperationName = "StartOrder",
    CorrelationInitializers =
    {
        new RequestReplyCorrelationInitializer
        {
            CorrelationHandle = RRHandle
        }
    }
};

SendReply ReplyToStartOrder = new SendReply
{
    Request = StartOrder,
    Content = … // Contains the return value, if any.
};

// Construct a workflow using StartOrder and ReplyToStartOrder.

相関関係を明示的に構成する代わりに、CorrelationScope アクティビティを使用することもできます。CorrelationScope は内包しているメッセージング アクティビティに暗黙の CorrelationHandle を提供します。この例では、Receive/SendReply ペアが CorrelationScope に内包されています。明示的な相関関係の構成は不要です。

Receive StartOrder = new Receive
{
    CanCreateInstance = true,
    ServiceContractName = OrderContractName,
    OperationName = "StartOrder"
};

SendReply ReplyToStartOrder = new SendReply
{
    Request = StartOrder,
    Content = … // Contains the return value, if any.
};

CorrelationScope s = new CorrelationScope
{
    Body = new Sequence
    {
        Activities = 
        {
            StartOrder,
            // Activities that create the reply.
            ReplyToStartOrder
        }
    }
};

// Construct a workflow using the CorrelationScope.

追加の相関関係が必要な場合は、目的の種類の CorrelationInitializer を使用する各メッセージング アクティビティの CorrelationInitializers プロパティを使用して、追加の相関関係を構成します。

Send/ReceiveReply による双方向の操作での相関関係の使用

Receive アクティビティは、WorkflowServiceHost によってホストされるワークフロー サービスでのみ使用できますが、Send および Send/ReceiveReply のペアは、Web サービスに対してメソッドを呼び出す必要のあるすべてのワークフローで使用できます。ワークフローが WorkflowServiceHost を使用してホストされる場合は、前のセクションで説明した既定の相関関係が適用されますが、そうでない場合は、目的の CorrelationInitializer と CorrelationHandle を明示的に使用するか、CorrelationScope による暗黙の処理管理を使用して、相関関係を構成する必要があります。

双方向の操作があるサービスで [サービス参照の追加] を使用する場合は、明示的に指定された Request/Reply 相関関係を使用して、内部に Send/ReceiveReply ペア アクティビティをラップするアクティビティが生成されます。