チュートリアル: Windows Communication Foundation クライアントを使用する

  • [アーティクル]

このチュートリアルでは、基本的な Windows Communication Foundation (WCF) アプリケーションの作成に必要な 5 つのタスクのうちの最後のタスクについて説明します。 このチュートリアルの概要については、「チュートリアル: Windows Communication Foundation アプリケーション入門」を参照してください。

Windows Communication Foundation (WCF) プロキシを作成して構成した後、クライアント インスタンスを作成し、クライアント アプリケーションをコンパイルします。 その後、それを WCF サービスとの通信に使用します。

このチュートリアルでは、以下の内容を学習します。

  • WCF クライアントを使用するためのコードを追加する。
  • WCF クライアントをテストする。

WCF クライアントを使用するためのコードを追加する

このクライアント コードで次のステップを実行します。

  • WCF クライアント プロキシのインスタンスを作成します。
  • 生成されたプロキシからサービス操作を呼び出します。
  • 操作の呼び出しが完了した後にクライアントを閉じます。

GettingStartedClient プロジェクトの Program.cs または Module1.vb ファイルを開き、そのコードを次のコードで置き換えます。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using GettingStartedClient.ServiceReference1;

namespace GettingStartedClient
{
    class Program
    {
        static void Main(string[] args)
        {
            //Step 1: Create an instance of the WCF proxy.
            CalculatorClient client = new CalculatorClient();

            // Step 2: Call the service operations.
            // Call the Add service operation.
            double value1 = 100.00D;
            double value2 = 15.99D;
            double result = client.Add(value1, value2);
            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

            // Call the Subtract service operation.
            value1 = 145.00D;
            value2 = 76.54D;
            result = client.Subtract(value1, value2);
            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

            // Call the Multiply service operation.
            value1 = 9.00D;
            value2 = 81.25D;
            result = client.Multiply(value1, value2);
            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

            // Call the Divide service operation.
            value1 = 22.00D;
            value2 = 7.00D;
            result = client.Divide(value1, value2);
            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

            // Step 3: Close the client to gracefully close the connection and clean up resources.
            Console.WriteLine("\nPress <Enter> to terminate the client.");
            Console.ReadLine();
            client.Close();
        }
    }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.ServiceModel
Imports GettingStartedClient.ServiceReference1

Module Module1

    Sub Main()
        ' Step 1: Create an instance of the WCF proxy.
        Dim Client As New CalculatorClient()

        ' Step 2: Call the service operations.
        ' Call the Add service operation.
        Dim value1 As Double = 100D
        Dim value2 As Double = 15.99D
        Dim result As Double = Client.Add(value1, value2)
        Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)

        ' Call the Subtract service operation.
        value1 = 145D
        value2 = 76.54D
        result = Client.Subtract(value1, value2)
        Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result)

        ' Call the Multiply service operation.
        value1 = 9D
        value2 = 81.25D
        result = Client.Multiply(value1, value2)
        Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)

        ' Call the Divide service operation.
        value1 = 22D
        value2 = 7D
        result = Client.Divide(value1, value2)
        Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)

        ' Step 3: Close the client to gracefully close the connection and clean up resources.
        Console.WriteLine()
        Console.WriteLine("Press <Enter> to terminate the client.")
        Console.ReadLine()
        Client.Close()

    End Sub

End Module

GettingStartedClient.ServiceReference1 をインポートする using (Visual C# の場合) または Imports (Visual Basic の場合) ステートメントがあることに注目してください。 サービス参照の追加機能を使用して Visual Studio で生成されたコードをこのステートメントによってインポートします。 このコードで WCF プロキシのインスタンスを作成し、電卓サービスによって公開されている各サービス操作を呼び出します。 その後、プロキシを閉じてプログラムを終了します。

WCF クライアントをテストする

Visual Studio からアプリケーションをテストする

  1. 保存し、ソリューションをビルドします。

  2. GettingStartedClient フォルダーを選択し、ショートカット メニューの [スタートアップ プロジェクトに設定] を選択します。

  3. [スタートアップ プロジェクト] でドロップダウン リストの [GettingStartedClient] を選択し、[実行] を選択するか、F5 キーを押します。

コマンド プロンプトからアプリケーションをテストする

  1. 管理者としてコマンド プロンプトを開き、Visual Studio ソリューションのディレクトリに移動します。

  2. サービスを開始するには、「GettingStartedHost\bin\Debug\GettingStartedHost.exe」と入力します。

  3. クライアントを開始するには、別のコマンド プロンプトを開き、Visual Studio ソリューションのディレクトリに移動して、「GettingStartedClient\bin\Debug\GettingStartedClient.exe」と入力します。

    GettingStartedHost.exe で生成される出力は次のとおりです。

    The service is ready.
Press <Enter> to terminate the service.

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

    GettingStartedClient.exe で生成される出力は次のとおりです。

    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 the client.

次のステップ

これで、WCF 入門チュートリアルのすべてのタスクが完了しました。 このチュートリアルでは、以下の内容を学習しました。

このチュートリアルでは、以下の内容を学習します。

  • WCF クライアントを使用するためのコードを追加する。
  • WCF クライアントをテストする。

いずれかの手順で問題やエラーが発生した場合は、トラブルシューティングの記事に記載されている手順に従って修正してください。

WCF の概要チュートリアルのトラブルシューティング