WCF客户端配置文件（参考）

可以使用 Windows Communication Foundation (WCF) 客户端配置来指定客户端终结点的地址 (Address)、绑定 (Binding)、行为 (Behavior) 和协定 (Contract)，即客户端终结点的“ABC”属性来连接服务终结点。  元素有一个  元素，其属性用于配置终结点的 ABC 属性。 这些属性将在本主题的“配置终结点”一节中讨论。

此外， 元素还包含一个  元素（用于指定元数据的导入导出设置）、一个  元素（包含自定义地址标头集合）和一个 元素（通过该元素，终结点可通过与其他终结点的消息交换来实现身份验证）。  和  元素是 EndpointAddress 的一部分，终结点地址主题将对这两个元素进行讨论。 本主题的“配置元数据”子节中提供了一些主题链接，这些主题对元数据扩展的使用进行说明。

 配置终结点

---

通过客户端配置，客户端可以指定一个或多个终结点，每个终结点都有自己的名称、地址和协定，并且每个终结点都引用客户端配置中要用于配置该终结点的 和  元素。 客户端配置文件应命名为“App.config”，因为这是 WCF 运行库所期望的名称。 下面的示例演示一个客户端配置文件。

  

        

                      name="endpoint1"

            address="http://localhost/ServiceModelSamples/service.svc"

            binding="wsHttpBinding"

            bindingConfiguration="WSHttpBinding_IHello"

            behaviorConfiguration="IHello_Behavior"

            contract="IHello" >

            

              

                                  type="Microsoft.ServiceModel.Samples.WsdlDocumentationImporter, WsdlDocumentation"/>

              

            

            

              

            

          

// Add another endpoint by adding another  element.

                      name="endpoint2">

           //Configure another endpoint here.

          

        

//The bindings section references by the bindingConfiguration endpoint attribute.

    

      

        

                 bypassProxyOnLocal="false" 

                 hostNameComparisonMode="StrongWildcard">

          

          

                           enabled="false" />

          

           //Security settings go here.

          

        

        

        //Configure this binding here.

        

          

        

//The behavior section references by the behaviorConfiguration endpoint attribute.

        

            

                

                    

                

            

        

可选的 name 属性唯一地标识了给定协定的终结点。 它由 ChannelFactory<</SPAN>TChannel> 或 ClientBase<</SPAN>TChannel> 用于指定客户端配置中的哪个终结点是目标终结点，必须在创建到服务的通道时加载。 通配符终结点配置名称“*”可用，并且指示 ApplyConfiguration 方法，如果文件中正好有一个终结点配置，就应加载该终结点配置，否则引发异常。 如果省略此属性，则将对应的终结点用作与指定协定类型相关联的默认终结点。 name 属性的默认值是一个空字符串，它与任何其他名称一样进行匹配。

每个终结点都必须具有一个与之关联的地址，用于查找和标识终结点。 address 属性可用来指定提供终结点位置的 URL。 但是，通过创建统一资源标识符 (URI)，也可以在代码中指定服务终结点的地址，使用 AddServiceEndpoint 方法之一可以将该地址添加到 ServiceHost。 有关更多信息，请参见终结点地址. 正如简介所述， 和  元素是 EndpointAddress 的组成部分，终结点地址主题中也对此进行了论述。

binding 属性指示终结点在连接到服务时期望使用的绑定类型。 该类型必须具有一个已注册的配置节，才能加以引用。 在上一示例中，该属性对应于 节，它指示终结点使用 WSHttpBinding。 实际上，终结点可以使用某个给定类型的多个绑定。 在 (binding) 类型元素中，所有这些绑定都有自己的  元素。 bindingconfiguration 属性用于区分相同类型的绑定。 其值与  元素的 name 属性匹配。 如何使用配置来配置客户端绑定的更多信息，请参见

behaviorConfiguration 属性用于指定终结点应使用  的哪个  的 。 其值与 的  元素的 name 属性匹配。 有关使用配置来指定客户端行为的示例，请参见配置客户端行为。

contract 属性指定终结点公开哪个协定。 此值对应于 ServiceContractAttribute 的 ConfigurationName。 默认值为实现相应服务的类的完整类型名。