次の方法で共有

本文別のルーティング

  • [アーティクル]

RouteByBody のサンプルでは、任意の SOAP アクションでメッセージ オブジェクトを受け入れるサービスを実装する方法を示します。 このサンプルは、電卓サービスを実装する「入門サンプル」に基づいています。 このサービスは、Calculate 要求パラメータを受け入れる 1 つの Message 操作を実装して、Message 応答を返します。

このサンプルでは、クライアントはコンソール アプリケーション (.exe) で、サービスは IIS によってホストされています。

Note

このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。

このサンプルでは、本文の内容に基づくメッセージ ディスパッチを示します。 組み込みの Windows Communication Foundation (WCF) サービス モデルのメッセージ ディスパッチ メカニズムは、メッセージの Action に基づいています。 ただし既存の多くの Web サービスでは、すべての操作が Action="" で定義されています。 アクション情報に基づいてディスパッチ要求メッセージを保持する WSDL を基準として、サービスを構築することはできません。 このサンプルでは、WSDL に基づくサービス コントラクトを示します (WSDL はこのサンプルに含まれる Service.wsdl 内に格納されています)。 このサービス コンストラクトは、「入門サンプル」で使用されているものと同様の電卓です。 ただし、[OperationContract] は、すべての操作に対して Action="" を指定します。

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples"),
                 XmlSerializerFormat, DispatchByBodyBehavior]
    public interface ICalculator
    {
        [OperationContract(Action="")]
        double Add(double n1, double n2);
        [OperationContract(Action = "")]
        double Subtract(double n1, double n2);
        [OperationContract(Action = "")]
        double Multiply(double n1, double n2);
        [OperationContract(Action = "")]
        double Divide(double n1, double n2);
    }

コントラクトが指定されている場合、サービスはカスタムのディスパッチ動作 DispatchByBodyBehavior に対して、複数の操作間でメッセージをディスパッチするように要求します。 このディスパッチ動作では、カスタムの DispatchByBodyElementOperationSelector 操作セレクターを、それぞれのラッパー要素の QName をキーとする操作名のテーブルを使用して初期化します。 DispatchByBodyElementOperationSelector は本文の最初の子の開始タグを参照し、前述のテーブルを使用して操作を選択します。

クライアントでは、ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe) を使用してサービスによってエクスポートされた WSDL から自動生成されたプロキシが使用されます。

svcutil.exe  /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples /uxs http://localhost/servicemodelsamples/service.svc?wsdl /out:generatedProxy.cs

すべての操作のアクションが空であっても、クライアント コードには影響ありません。ただし、自動生成されたプロキシ内の Action パラメータは例外です。

クライアント コードは、複数の計算を実行します。 このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。 クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。

Add(100, 15.99) = 115.99
Subtract(145, 76.54) = 68.46
Multiply(9, 81.25) = 731.25
Divide(22, 7) = 3.14285714285714

Press <ENTER> to terminate client.

サンプルをセットアップ、ビルド、および実行するには

  1. Windows Communication Foundation サンプルの 1 回限りのセットアップの手順を実行したことを確認します。

  2. ソリューションをビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。

  3. 単一または複数コンピューター構成でサンプルを実行するには、「Windows Communication Foundation サンプルの実行」の手順に従います。