发现绑定元素示例

本示例演示如何使用发现客户端绑定元素发现服务。开发人员使用此功能可以向其现有客户端通道堆栈添加发现客户端通道，从而使编程模型非常直观。当关联通道打开时，会使用发现解析服务地址。本示例包含以下项目：

• CalculatorService：可发现的 WCF 服务。

• CalculatorClient：使用发现客户端通道搜索并调用 CalculatorService 的 WCF 客户端应用程序。

• DynamicCalculatorClient：使用动态终结点搜索并调用 CalculatorService 的 WCF 客户端应用程序。

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

CalculatorService

此项目包含一个实现 ICalculatorService 协定的简单计算器服务。

下面的 App.config 文件用于在服务行为和发现终结点中添加 <serviceDiscovery> 行为。

<system.serviceModel>
    <services>
      <service behaviorConfiguration="CalculatorBehavior" name="Microsoft.Samples.Discovery.CalculatorService">
        <endpoint name="udpDiscoveryEpt" kind="udpDiscoveryEndpoint" />
      </service>
    </services>
    <behaviors>
      <!--Enable discovery through configuration.-->
      <serviceBehaviors>
        <behavior name="CalculatorBehavior">
          <serviceDiscovery>
          </serviceDiscovery>
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>

这使得服务及其终结点可发现。CalculatorService 是使用 NetTcpBinding 绑定添加一个终结点的自承载服务。它还向终结点添加 EndpointDiscoveryBehavior 并指定范围，如下面的节点中所示。

// Add a NET.TCP endpoint and add a scope to that endpoint.
ServiceEndpoint netTcpEndpoint = serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new NetTcpBinding(), netTcpAddress);
EndpointDiscoveryBehavior netTctEndpointBehavior = new EndpointDiscoveryBehavior();
netTctEndpointBehavior.Scopes.Add(new Uri("ldap:///ou=engineering,o=exampleorg,c=us"));
netTcpEndpoint.Behaviors.Add(netTctEndpointBehavior);
serviceHost.Open();

CalculatorClient

此项目包含一个向 CalculatorService 发送消息的客户端实现。此程序使用 CreateCustomBindingWithDiscoveryElement() 方法创建一个使用 Discovery 客户端通道的自定义绑定。

static CustomBinding CreateCustomBindingWithDiscoveryElement()
 {
      DiscoveryClientBindingElement discoveryBindingElement = new DiscoveryClientBindingElement();
            
            // Provide the search criteria and the endpoint over which the probe is sent
            discoveryBindingElement.FindCriteria = new FindCriteria(typeof(ICalculatorService));
            discoveryBindingElement.DiscoveryEndpointProvider = new UdpDiscoveryEndpointProvider();

            CustomBinding customBinding = new CustomBinding(new NetTcpBinding());
            // Insert DiscoveryClientBindingElement at the top of the BindingElement stack.
            // An exception is thrown if this binding element is not at the top
            customBinding.Elements.Insert(0, discoveryBindingElement);

            return customBinding; }

DiscoveryClientBindingElement 实例化后，开发人员指定搜索服务时要使用的条件。在本例中，发现查找条件是 ICalculatorService 类型。此外，开发人员还指定一个 DiscoveryEndpointProvider，它返回指定要在何处查找服务的 DiscoveryEndpoint。DiscoveryEndpointProvider 返回新的 DiscoveryEndpoint 实例。有关更多信息，请参见 通过 Discovery 客户端通道使用自定义绑定.

// Extend DiscoveryEndpointProvider class to change the default DiscoveryEndpoint
    // to the DiscoveryClientBindingElement. The Discovery ClientChannel 
    // uses this endpoint to send Probe message.
    public class UdpDiscoveryEndpointProvider : DiscoveryEndpointProvider
    {
        public override DiscoveryEndpoint GetDiscoveryEndpoint()
        {
            return new UdpDiscoveryEndpoint(DiscoveryVersion.WSDiscoveryApril2005);
        }
    }

在本例中，客户端使用 Discovery 协议定义的 UDP 多播机制在本地子网上搜索服务。方法的其余部分创建自定义绑定并将 Discovery 绑定元素插入堆栈顶部。

注意：
DiscoveryClientBindingElement 必须放置在绑定堆栈顶部。DiscoveryClientBindingElement 之上的任何 BindingElement 都必须确保其创建的通道工厂或通道不使用 EndpointAddress 或 Via 属性，因为实际地址只能在 Discovery 客户端通道上发现。

接下来，可以通过传入此自定义绑定和终结点地址来实例化 CalculatorClient。

 CalculatorServiceClient client = new CalculatorServiceClient(CreateCustomBindingWithDiscoveryElement(), DiscoveryClientBindingElement.DiscoveryEndpointAddress);

使用 Discovery 客户端通道时，会传入之前指定的固定终结点地址。现在，在运行时，Discovery 客户端通道会查找由查找条件指定的服务并连接到该服务。若要使服务和客户端建立连接，它们必须具有相同的基础绑定堆栈。

使用此示例

1. 在 Visual Studio 2010 中打开解决方案。

2. 生成解决方案。

3. 运行服务应用程序和每个客户端应用程序。

4. 观察客户端是否能够在不知道服务地址的情况下找到服务。