大网数据广告活动
.NET 与 C# 开发

客户端配置

· 52CE 我爱测

Windows Communication Foundation (WCF) 客户端配置可用于指定地址、 绑定、 行为和协定,客户端终结点,哪些客户端用于连接到服务终结点的"ABC"属性。 <客户端 >元素具有<终结点 >元素,其属性用于配置终结点的 abc 属性。 在讨论这些属性配置终结点部分。

Windows Communication Foundation (WCF) 客户端配置可用于指定地址、 绑定、 行为和协定,客户端终结点,哪些客户端用于连接到服务终结点的"ABC"属性。 <客户端 >元素具有<终结点 >元素,其属性用于配置终结点的 abc 属性。 在讨论这些属性配置终结点部分。

<终结点 >元素还包含<元数据 >元素用于指定导入和导出元数据,用于设置 <标头 >包含一个自定义地址标头集合的元素和一个<标识 >启用的其他终结点的终结点的身份验证的元素交换与它的消息。 <标头 >并<标识 >元素属于xref:System.ServiceModel.EndpointAddress进行的讨论会在地址一文。 中提供了指向这些主题介绍使用元数据的扩展配置元数据部分。

配置终结点

设计客户端配置为允许客户端可以指定一个或多个终结点,每个都有其自己的名称、 地址和协定,并且每个引用<绑定 >并 <行为 >要用来配置该终结点的客户端配置中的元素。 客户端配置文件应命名为"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 属性唯一地标识了给定协定的终结点。 它由 xref:System.ServiceModel.ChannelFactory`1.%23ctor* 或 xref:System.ServiceModel.ClientBase`1.%23ctor* 用于指定客户端配置中的哪个终结点是目标终结点,必须在创建到服务的通道时加载。 通配符终结点配置名称"*"可用并且指示xref:System.ServiceModel.ChannelFactory.ApplyConfiguration*,就应加载该文件中的任何终结点配置,前提是正好有一个可用,或其他类型的方法将引发异常。 如果省略此属性,则将对应的终结点用作与指定协定类型相关联的默认终结点。 name 属性的默认值是一个空字符串,它与任何其他名称一样进行匹配。

每个终结点都必须具有一个与之关联的地址,用于查找和标识终结点。 address 属性可用来指定提供终结点位置的 URL。 但是,通过创建统一资源标识符 (URI),也可以在代码中指定服务终结点的地址,使用 xref:System.ServiceModel.ServiceHost 方法之一可以将该地址添加到 xref:System.ServiceModel.ServiceHost.AddServiceEndpoint*。 有关详细信息,请参阅地址。 正如简介, <标头 >并<标识 >元素属于xref:System.ServiceModel.EndpointAddress和中还讨论了地址主题。

binding 属性指示终结点在连接到服务时期望使用的绑定类型。 该类型必须具有一个已注册的配置节,才能加以引用。 在上一示例中,这是 <wsHttpBinding >部分中,它指示终结点使用xref:System.ServiceModel.WSHttpBinding。 实际上,终结点可以使用某个给定类型的多个绑定。 每个具有其自己<绑定 > (binding) 类型元素中的元素。 bindingconfiguration 属性用于区分相同类型的绑定。 其值符合name的属性<绑定 >元素。 有关如何配置客户端绑定使用的配置,请参阅如何:在配置中指定客户端绑定。

behaviorConfiguration属性用于指定哪些<行为 >的 <endpointBehaviors >终结点应使用。 其值符合name的属性<行为 >元素。 有关使用配置来指定客户端行为的示例,请参阅配置客户端行为。

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

配置元数据

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

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。