自定义绑定可靠会话

项目
09/04/2008

自定义绑定由离散绑定元素的有序列表定义。本示例演示如何使用各种传输和消息编码元素配置自定义绑定，特别是启用可靠会话。

可靠会话提供可靠的消息和会话功能。可靠消息在失败时重新尝试通信并允许指定传递保证（如消息按顺序抵达）。会话在调用之间将保持客户端的状态。此示例实现了用来保持客户端状态的会话，并指定了按顺序传递保证。此示例基于实现计算器服务的入门示例。可靠会话功能是在客户端和服务的应用程序配置文件中启用和配置的。

提示

本主题的最后介绍了此示例的设置过程和生成说明。

在定义自定义绑定时，绑定元素的排序顺序很重要，因为每个元素都表示通道堆栈中的某一层（请参见Custom Bindings）。

示例的服务配置定义如下：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service 
          name="Microsoft.ServiceModel.Samples.CalculatorService"
          behaviorConfiguration="CalculatorServiceBehavior">
        <!-- This endpoint is exposed at the base address provided by host: https://localhost/servicemodelsamples/service.svc  -->
        <!-- specify customBinding binding and a binding configuration to use -->
        <endpoint address=""
                  binding="customBinding"
                  bindingConfiguration="Binding1" 
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <!-- The mex endpoint is exposed at https://localhost/servicemodelsamples/service.svc/mex -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>

    <!-- custom binding configuration - configures HTTP transport, reliable sessions -->
    <bindings>
      <customBinding>
        <binding name="Binding1">
          <reliableSession />
          <security authenticationMode="SecureConversation"
                     requireSecurityContextCancellation="true">
          </security>
          <compositeDuplex />
          <oneWay />
          <textMessageEncoding messageVersion="Soap12WSAddressing10" writeEncoding="utf-8" />
          <httpTransport authenticationScheme="Anonymous" bypassProxyOnLocal="false"
                        hostNameComparisonMode="StrongWildcard" 
                        proxyAuthenticationScheme="Anonymous" realm="" 
                        useDefaultWebProxy="true" />
        </binding>
      </customBinding>
    </bindings>

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

  </system.serviceModel>

</configuration>

在跨计算机方案中运行时，必须更改客户端的终结点地址以反映服务的主机名。

运行示例时，操作请求和响应将显示在客户端控制台窗口中。在客户端窗口中按 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.

设置、生成和运行示例

请确保已经执行了 Windows Communication Foundation 示例的一次性安装过程。
若要生成 C# 或 Visual Basic .NET 版本的解决方案，请按照生成 Windows Communication Foundation 示例中的说明进行操作。
若要用单机配置或跨计算机配置来运行示例，请按照运行 Windows Communication Foundation 示例中的说明进行操作。

提示

在使用跨计算机的配置运行客户端时，请确保用相应的计算机名替换Service Endpoint元素的 address 属性和 compositeDuplex element的 clientBaseAddress 属性中的“localhost”，如下面的示例所示：
```
<endpoint name = ""
address="http://service_machine_name/servicemodelsamples/service.svc"
... />
<compositeDuplex clientBaseAddress="http://client_machine_name:8000/myClient/" />
```

通过

自定义绑定可靠会话

设置、生成和运行示例

其他资源