チュートリアル: 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 からアプリケーションをテストする
保存し、ソリューションをビルドします。
GettingStartedClient フォルダーを選択し、ショートカット メニューの [スタートアップ プロジェクトに設定] を選択します。
[スタートアップ プロジェクト] でドロップダウン リストの [GettingStartedClient] を選択し、[実行] を選択するか、F5 キーを押します。
コマンド プロンプトからアプリケーションをテストする
管理者としてコマンド プロンプトを開き、Visual Studio ソリューションのディレクトリに移動します。
サービスを開始するには、「GettingStartedHost\bin\Debug\GettingStartedHost.exe」と入力します。
クライアントを開始するには、別のコマンド プロンプトを開き、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 クライアントをテストする。
いずれかの手順で問題やエラーが発生した場合は、トラブルシューティングの記事に記載されている手順に従って修正してください。