TCP 激活

项目
05/10/2023

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;
    }
}

本示例使用 net.tcp 绑定的变体，该绑定启用 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 示例的一次性安装过程。

此外，必须安装 WCF 非 HTTP 激活组件：
1. 从“开始”菜单中，选择“控制面板” 。
2. 选择“程序和功能”。
3. 单击“打开或关闭 Windows 组件”。
4. 展开“Microsoft .NET Framework 3.0”节点并选中“Windows Communication Foundation 非 HTTP 激活”功能。
配置 WAS 以支持 TCP 激活。

为方便起见，在位于示例目录中名为 AddNetTcpSiteBinding.cmd 的批处理文件中实现以下两个步骤。
1. 若要支持 net.tcp 激活，必须首先将默认的网站绑定到一个 net.tcp 端口。可以使用随 Internet 信息服务 7.0 (IIS) 管理工具集一起安装的 Appcmd.exe 来完成此操作。在管理员级别命令提示符处，运行以下命令：
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" -+bindings.[protocol='net.tcp',bindingInformation='808:*']
```
  提示
  
  此命令是单行文本。此命令将 net.tcp 网站绑定添加到以任何主机名侦听 TCP 端口 808 的默认网站。
2. 尽管网站内的所有应用程序共享一个公共 net.tcp 绑定，但是每个应用程序可以单独启用 net.tcp 支持。若要启用 /servicemodelsamples 应用程序的 net.tcp，请在管理员级别命令提示符处运行以下命令：
```
%windir%\system32\inetsrv\appcmd.exe set app
"Default Web Site/servicemodelsamples" /enabledProtocols:http,net.tcp
```
  备注
  
  此命令是单行文本。此命令可实现能够使用 http://localhost/servicemodelsamples 和 net.tcp://localhost/servicemodelsamples 访问 /servicemodelsamples 应用程序。
若要生成 C# 或 Visual Basic .NET 版本的解决方案，请按照 Building the Windows Communication Foundation Samples中的说明进行操作。
要使用单机配置或跨计算机配置运行示例，请按照运行 Windows Communication Foundation 示例中的说明进行操作。

移除为此示例添加的 net.tcp 网站绑定。

为方便起见，在位于示例目录中名为 RemoveNetTcpSiteBinding.cmd 的批处理文件中实现以下两个步骤。
1. 通过在管理员级别命令提示符处运行以下命令，可从启用的协议列表移除 net.tcp：
```
%windir%\system32\inetsrv\appcmd.exe set app
"Default Web Site/servicemodelsamples" /enabledProtocols:http
```
  备注
  
  必须以单行文本的形式输入此命令。
2. 通过在管理员级别命令提示符处运行以下命令，可移除 net.tcp 站点绑定：
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"
--bindings.[protocol='net.tcp',bindingInformation='808:*']
```
  备注
  
  必须以单行文本的形式键入此命令。

另请参阅

AppFabric 承载和持久性示例

通过

TCP 激活

设置、生成和运行示例

另请参阅

其他资源