TCP のアクティブ化

2025-06-17

TCPActivation サンプルでは、Windows プロセスライセンス認証サービス (WAS) を使用して net.tcp プロトコル経由で通信するサービスをアクティブ化するサービスをホストする方法を示します。このサンプルは、入門に基づいています。

注

このサンプルのセットアップ手順とビルド手順は、このトピックの最後にあります。

サンプルは、クライアントコンソールプログラム (.exe) と、WAS によってアクティブ化されたワーカープロセスでホストされるサービスライブラリ (.dll) で構成されています。クライアントアクティビティはコンソールウィンドウに表示されます。

このサービスは、要求/応答通信パターンを定義するコントラクトを実装します。コントラクトは、次のサンプルコードに示すように、算術演算 (加算、減算、乗算、除算) を公開する ICalculator インターフェイスによって定義されます。

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

サービス実装は、適切な結果を計算して返します。

// Service class that implements the service contract.
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        return n1 + n2;
    }
    public double Subtract(double n1, double n2)
    {
        return n1 - n2;
    }
    public double Multiply(double n1, double n2)
    {
        return n1 * n2;
    }
    public double Divide(double n1, double n2)
    {
        return n1 / n2;
    }
}

このサンプルでは、TCP ポート共有が有効でセキュリティがオフになっている net.tcp バインディングのバリアントを使用しています。セキュリティで保護された TCP バインディングを使用する場合は、サーバーのセキュリティモードを目的の設定に変更し、クライアントで Svcutil.exe 再実行して更新クライアント構成ファイルを生成します。

次の例は、サービスの構成を示しています。

<system.serviceModel>

    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">
        <!-- This endpoint is exposed at the base address provided by host: net.tcp://localhost/servicemodelsamples/service.svc  -->
        <endpoint binding="netTcpBinding" bindingConfiguration="PortSharingBinding"
          contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <!-- the mex endpoint is exposed at net.tcp://localhost/servicemodelsamples/service.svc/mex -->
        <endpoint address="mex"
                  binding="mexTcpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>
    <bindings>
      <netTcpBinding>
        <binding name="PortSharingBinding" portSharingEnabled="true">
          <security mode="None" />
        </binding>
      </netTcpBinding>
    </bindings>

    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <serviceMetadata />
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>

  </system.serviceModel>

クライアントのエンドポイントは、次のサンプルコードに示すように構成されます。

<system.serviceModel>
    <bindings>
        <netTcpBinding>
          <binding name="NetTcpBinding_ICalculator">
            <security mode="None"/>
          </binding>
        </netTcpBinding>
    </bindings>
    <client>
        <endpoint address="net.tcp://localhost/servicemodelsamples/service.svc"
            binding="netTcpBinding" bindingConfiguration="NetTcpBinding_ICalculator"
            contract="Microsoft.ServiceModel.Samples.ICalculator" name="NetTcpBinding_ICalculator" />
    </client>
</system.serviceModel>

サンプルを実行すると、操作要求と応答がクライアントコンソールウィンドウに表示されます。クライアントウィンドウで 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.

サンプルを設定、ビルド、実行するには

IIS 7.0 がインストールされていることを確認します。 WAS ライセンス認証には IIS 7.0 が必要です。
Windows Communication Foundation サンプルのOne-Time セットアップ手順を実行していることを確認します。

さらに、WCF 非 HTTP アクティブ化コンポーネントをインストールする必要があります。
1. [スタート] メニューの [コントロールパネル] を選択します。
2. [ プログラムと機能] を選択します。
3. [ Windows コンポーネントのオンとオフを切り替える] をクリックします。
4. Microsoft .NET Framework 3.0 ノードを展開し、Windows Communication Foundation の非 HTTP アクティブ化機能を確認します。
TCP アクティブ化をサポートするように WAS を構成します。

便宜上、次の 2 つの手順は、サンプルディレクトリにある AddNetTcpSiteBinding.cmd という名前のバッチファイルに実装されます。
1. net.tcp のアクティブ化をサポートするには、既定の Web サイトを最初に net.tcp ポートにバインドする必要があります。これは、インターネットインフォメーションサービス 7.0 (IIS) 管理ツールセットと共にインストールされる Appcmd.exeを使用して行うことができます。管理者レベルのコマンドプロンプトから、次のコマンドを実行します。
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" -+bindings.[protocol='net.tcp',bindingInformation='808:*']
```
  ヒント
  
  このコマンドは 1 行のテキストです。このコマンドは、任意のホスト名で TCP ポート 808 でリッスンしている既定の Web サイトに net.tcp サイトバインドを追加します。
2. サイト内のすべてのアプリケーションは共通の net.tcp バインドを共有しますが、各アプリケーションで net.tcp のサポートを個別に有効にすることができます。 /servicemodelsamples アプリケーションで net.tcp を有効にするには、管理者レベルのコマンドプロンプトから次のコマンドを実行します。
```
%windir%\system32\inetsrv\appcmd.exe set app
"Default Web Site/servicemodelsamples" /enabledProtocols:http,net.tcp
```
  注
  
  このコマンドは 1 行のテキストです。このコマンドを使用すると、 http://localhost/servicemodelsamples と net.tcp://localhost/servicemodelsamplesの両方を使用して/servicemodelsamples アプリケーションにアクセスできます。
ソリューションの C# または Visual Basic .NET エディションをビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。
シングルコンピューター構成またはクロスコンピューター構成でサンプルを実行するには、「 Windows Communication Foundation サンプルの実行」の手順に従います。

このサンプル用に追加した net.tcp サイトバインドを削除します。

便宜上、次の 2 つの手順は、サンプルディレクトリにある RemoveNetTcpSiteBinding.cmd という名前のバッチファイルに実装されます。
1. 管理者レベルのコマンドプロンプトから次のコマンドを実行して、有効なプロトコルの一覧から net.tcp を削除します。
```
%windir%\system32\inetsrv\appcmd.exe set app
"Default Web Site/servicemodelsamples" /enabledProtocols:http
```
  注
  
  このコマンドは、1 行のテキストとして入力する必要があります。
2. 管理者レベルのコマンドプロンプトから次のコマンドを実行して、net.tcp サイトバインドを削除します。
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"
--bindings.[protocol='net.tcp',bindingInformation='808:*']
```
  注
  
  このコマンドは、1 行のテキストとして入力する必要があります。

こちらも参照ください

AppFabric ホスティングと永続化のサンプル

次の方法で共有

TCP のアクティブ化

サンプルを設定、ビルド、実行するには

こちらも参照ください

その他のリソース