客户端配置

项目
04/07/2023

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

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

配置终结点

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

<?xml version="1.0" encoding="utf-8"?>  
<configuration>  
  <system.serviceModel>  
        <client>  
          <endpoint  
            name="endpoint1"  
            address="http://localhost/ServiceModelSamples/service.svc"  
            binding="wsHttpBinding"  
            bindingConfiguration="WSHttpBinding_IHello"  
            behaviorConfiguration="IHello_Behavior"  
            contract="IHello" >  
  
            <metadata>  
              <wsdlImporters>  
                <extension  
                  type="Microsoft.ServiceModel.Samples.WsdlDocumentationImporter, WsdlDocumentation"/>  
              </wsdlImporters>  
            </metadata>  
  
            <identity>  
              <servicePrincipalName value="host/localhost" />  
            </identity>  
          </endpoint>  
            <!-- Add another endpoint by adding another <endpoint> element. -->
          <endpoint  
            name="endpoint2">  
           //Configure another endpoint here.  
          </endpoint>  
        </client>  
  
<!-- The bindings section references by the bindingConfiguration endpoint attribute.   -->
    <bindings>  
      <wsHttpBinding>  
        <binding name="WSHttpBinding_IHello"
                 bypassProxyOnLocal="false"
                 hostNameComparisonMode="StrongWildcard">  
          <readerQuotas maxDepth="32"/>  
          <reliableSession ordered="true"
                           enabled="false" />  
          <security mode="Message">  
           <!-- Security settings go here.   -->
          </security>  
        </binding>  
        <binding name="Another Binding"  
          <!-- Configure this binding here. -->  
        </binding>  
          </wsHttpBinding>  
     </bindings>  
  
<!-- The behavior section references by the behaviorConfiguration endpoint attribute.   -->
        <behaviors>  
            <endpointBehaviors>  
                <behavior name=" IHello_Behavior ">  
                    <clientVia />  
                </behavior>  
            </endpointBehaviors>  
        </behaviors>  
  
    </system.serviceModel>  
</configuration>

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

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

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

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

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

配置元数据

使用 <metadata> 元素指定用于注册元数据导入扩展的设置。有关扩展元数据系统的详细信息，请参阅扩展元数据系统。

客户端配置

配置终结点

配置元数据

另请参阅

其他资源