自定义绑定可靠会话

项目
05/09/2023

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

示例详细信息

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

注意

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

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

示例的服务配置定义如下面的代码示例所示。

<?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: http://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 http://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.

设置、生成和运行示例

使用以下命令安装 ASP.NET 4.0：

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

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

重要

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

通过

自定义绑定可靠会话

示例详细信息

设置、生成和运行示例

其他资源