WSHttpBinding

此示例演示如何使用 Windows Communication Foundation (WCF) 实现典型的服务和典型的客户端。此示例由客户端控制台程序 (client.exe) 和 Internet 信息服务 (IIS) 所承载的服务库组成。该服务实现定义“请求-答复”通信模式的协定。该协定由 ICalculator 接口定义，此接口公开数学运算（加、减、乘和除）。客户端向给定的数学运算发出同步请求，服务使用结果进行回复。客户端活动显示在控制台窗口中。

注意：
您的计算机上可能已安装这些示例。在继续操作之前，请先检查以下（默认）目录： <安装驱动器>:\WF_WCF_Samples 如果此目录不存在，请访问针对 .NET Framework 4 的 Windows Communication Foundation (WCF) 和 Windows Workflow Foundation (WF) 示例（可能为英文网页），下载所有 Windows Communication Foundation (WCF) 和 WF 示例。此示例位于以下目录。 <安装驱动器>:\WF_WCF_Samples\WCF\Basic\Binding\WS\wsHttp

注意：
本主题的最后提供了此示例的设置过程和生成说明。

此示例使用 wsHttpBinding Element公开 ICalculator 协定。此绑定的配置已在 Web.config 文件中展开。

<bindings>
  <wsHttpBinding>
    <!--The following is the expanded configuration section for a-->
    <!--WSHttpBinding. Each property is configured with the default--> 
    <!--value. See the ReliableSession, TransactionFlow, -->
    <!--TransportSecurity, and MessageSecurity samples in the WS -->
    <!--directory to learn how to configure these features. -->
    <binding name="Binding1"
              bypassProxyOnLocal="false" 
              transactionFlow="false" 
              hostNameComparisonMode="StrongWildcard"
              maxBufferPoolSize="524288" 
              maxReceivedMessageSize="65536"
              messageEncoding="Text" 
              textEncoding="utf-8" 
              useDefaultWebProxy="true"
              allowCookies="false">
      <reliableSession ordered="true" 
                       inactivityTimeout="00:10:00"
                       enabled="false" />
      <security mode="Message">
        <message clientCredentialType="Windows" 
                 negotiateServiceCredential="true"
                 algorithmSuite="Default" 
                 establishSecurityContext="true" />
      </security>
    </binding>
  </wsHttpBinding>
</bindings>

在基 binding 元素上，通过 maxReceivedMessageSize 值可以配置传入消息的最大大小（以字节为单位）。通过 hostNameComparisonMode 值，可以配置向服务多路分解消息时是否考虑主机名。通过 messageEncoding 值，可以配置针对消息使用文本还是使用 MTOM 编码。通过 textEncoding 值可以为消息配置字符编码。通过 bypassProxyOnLocal 值可以配置是否对本地通信使用 HTTP 协议。通过 transactionFlow 值可以配置是否对当前事务进行流处理（如果为事务流配置了操作）。

在 <reliableSession> element 元素上，启用的布尔值配置是否启用可靠会话。ordered 值配置是否保留消息顺序。inactivityTimeout 值配置会话在出错之前可以闲置的时间。

在 security element of wsHttpBinding上，mode 值配置应使用哪种安全模式。此示例中使用了消息安全性，这也是在 security element of wsHttpBinding中指定 message element of wsHttpBinding的原因。

运行示例时，操作请求和响应将显示在客户端控制台窗口中。在客户端窗口中按 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. 使用以下命令安装 ASP.NET 4.0。

   %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable
   

2. 请确保已执行 Windows Communication Foundation 示例的一次性安装过程。

3. 若要生成 C# 或 Visual Basic .NET 版本的解决方案，请按照生成 Windows Communication Foundation 示例中的说明进行操作。

4. 若要用单机配置或跨计算机配置来运行示例，请按照Running the Windows Communication Foundation Samples中的说明进行操作。