チャネル ファクトリ

  • [アーティクル]

ChannelFactory サンプルでは、クライアント アプリケーションが、生成されたクライアントではなく ChannelFactory クラスを含むチャネルを作成できる方法を示します。 このサンプルは、電卓サービスを実装する「入門サンプル」に基づいています。

Note

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

このサンプルは、ChannelFactory<TChannel> クラスを使用して、サービス エンドポイントにチャネルを作成します。 通常、サービス エンドポイントへのチャネルを作成するには、ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe) を使用してクライアント型を生成し、生成された型のインスタンスを作成します。 また、ChannelFactory<TChannel> クラスを使用してチャネルを作成することもできます。サンプルを参照してください。 次のサンプル コードで作成されるサービスは、「入門サンプル」のサービスと同じものです。

EndpointAddress address = new EndpointAddress("http://localhost/servicemodelsamples/service.svc");
WSHttpBinding binding = new WSHttpBinding();
ChannelFactory<ICalculator> factory = new
                    ChannelFactory<ICalculator>(binding, address);
ICalculator channel = factory.CreateChannel();

重要

このサンプルを複数コンピュータのシナリオで実行している場合は、前述のコードの "localhost" を、サービスを実行中のコンピュータの完全修飾名に置き換える必要があります。 このサンプルは、エンドポイント アドレスを設定する構成を使用していません。したがって、コード内でアドレスを設定する必要があります。

チャネルが作成されたら、生成されたクライアントと同様にサービス操作を呼び出すことができます。

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

チャネルを閉じるには、最初にチャネルを IClientChannel インターフェイスにキャストする必要があります。 これは、生成されたチャネルが ICalculator インターフェイスによってクライアント アプリケーション内で宣言されているからです。このインターフェイスには Add および Subtract などのメソッドは含まれていますが、Close は含まれていません。 Close メソッドは、ICommunicationObject インターフェイスで発生します。

// Close the channel.
 ((IClientChannel)client).Close();

このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。 クライアント アプリケーションをシャットダウンするには、クライアント ウィンドウで 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. ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「 Building the Windows Communication Foundation Samples」の手順に従います。 このサンプルではメタデータの公開は有効化されないことに注意してください。 最初にこのサンプルのメタデータ公開を有効にして、クライアント型を再生成する必要があります。

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

サンプルを複数コンピュータで実行するには

次のコードの "localhost" を、サービスを実行中のコンピューターの完全修飾名に置き換えます。

EndpointAddress address = new EndpointAddress("http://localhost/servicemodelsamples/service.svc");