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

为 Windows Communication Foundation 服务配置绑定

· 52CE 我爱测

创建应用程序时,您经常需要将一些决策交给管理员在部署应用程序后制定。 例如,通常没有办法提前知道服务地址或统一资源标识符 (URI)。 最好允许管理员在创建服务后指定地址,而不是对地址进行硬编码。 这种灵活性是通过配置实现的。

创建应用程序时,您经常需要将一些决策交给管理员在部署应用程序后制定。 例如,通常没有办法提前知道服务地址或统一资源标识符 (URI)。 最好允许管理员在创建服务后指定地址,而不是对地址进行硬编码。 这种灵活性是通过配置实现的。

Note: 使用ServiceModel Metadata Utility Tool (Svcutil.exe)与/config开关来快速创建配置文件。

主要部分

Windows Communication Foundation (WCF) 配置架构包括以下三个主要部分 (serviceModel, bindings,和services):

<configuration>  
    <system.serviceModel>  
        <bindings>  
        </bindings>  
        <services>  
        </services>  
        <behaviors>  
        </behaviors>  
    </system.serviceModel>  
</configuration>  

ServiceModel 元素

可以使用界定的部分system.ServiceModel元素可与一个或多个终结点,以及服务的设置配置的服务类型。 然后,可以为每个终结点配置地址、协定以及绑定。 有关终结点的详细信息,请参阅终结点创建概述。 如果未指定任何终结点,则运行时添加默认终结点。 有关默认终结点、绑定和行为的详细信息,请参阅简化配置和 WCF 服务的简化配置。

绑定指定传输(HTTP、TCP、管道、消息队列)和协议(安全性、可靠性、事务流)。绑定由绑定元素组成,其中的每个元素都指定终结点与世界的通信方式的一个方面。

例如,指定 <basicHttpBinding >元素指示要使用 HTTP 作为传输协议的终结点。 这用于在使用此终结点的服务打开时在运行时连接终结点。

有两种绑定:预定义绑定和自定义绑定。 预定义绑定包含在常见方案中使用的元素的有用组合。 WCF 提供的预定义的绑定类型的列表,请参阅System-Provided Bindings。 如果没有任何预定义绑定集合具有服务应用程序所需的功能的正确组合,那么你可以构造自定义绑定来满足应用程序的需求。 有关自定义绑定的详细信息,请参阅 <customBinding >。

以下四个示例说明了用于设置 WCF 服务的最常见绑定配置。

指定终结点以使用绑定类型

第一个示例说明如何指定一个配置了地址、协定和绑定的终结点。

<service name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null">  
  <!-- This section is optional with the default configuration introduced  
       in .NET Framework 4. -->  
  <endpoint   
      address="/HelloWorld2/"  
      contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
      binding="basicHttpBinding" />
</service>  

在本示例中,name 属性表示使用该配置的服务类型。 当您用 HelloWorld 协定通过代码中创建服务时,它将以示例配置中定义的所有终结点进行初始化。 如果此程序集实现只有一个服务协定,name属性可以省略,因为服务使用唯一可用的类型。 该属性采用字符串,该字符串必须遵循以下格式:Namespace.Class, AssemblyName, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null

address 属性指定其他终结点用于与该服务通信的 URI。 该 URI 可以是绝对路径,也可以是相对路径。 如果提供的是相对地址,则需要主机提供适合于绑定中所使用的传输方案的基址。 如果未配置地址,则假定基址为该终结点的地址。

contract 属性指定该终结点所公开的协定。 服务实现类型必须实现该协定类型。 如果服务实现所实现的是单个协定类型,则可以省略此属性。

binding 属性选择要用于此特定终结点的预定义或自定义绑定。 不显式选择绑定的终结点使用默认绑定选择,即 BasicHttpBinding。

修改预定义绑定

在下面的示例中,修改了预定义绑定。 然后可以将该绑定用于配置服务中的任意终结点。 可通过将 xref:System.ServiceModel.Configuration.IBindingConfigurationElement.ReceiveTimeout* 值设置为 1 秒的方式来修改绑定。 请注意,该属性返回一个 xref:System.TimeSpan 对象。

在绑定部分中可以找到该更改的绑定。 现在,通过在 binding 元素中设置 endpoint 特性,可以在创建任何终结点时使用该更改的绑定。

Note: 如果为该绑定指定了特定名称,则服务终结点中指定的 bindingConfiguration 必须与其相匹配。

<service name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null">  
  <endpoint   
      address="/HelloWorld2/"  
      contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
      binding="basicHttpBinding" />
</service>  
<bindings>  
    <basicHttpBinding   
        receiveTimeout="00:00:01"  
    />  
</bindings>  

配置要应用于服务的行为

在下面的示例中,为该服务类型配置了一个特定的行为。 ServiceMetadataBehavior元素用于使ServiceModel Metadata Utility Tool (Svcutil.exe)查询服务并从元数据生成 Web 服务描述语言 (WSDL) 文档。

Note: 如果为该行为指定了特定名称,则服务或终结点部分中指定的 behaviorConfiguration 必须与其相匹配。

<behaviors>  
    <behavior>  
        <ServiceMetadata httpGetEnabled="true" />   
    </behavior>  
</behaviors>  
<services>  
    <service   
       name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null">
       <endpoint   
          address="http://computer:8080/Hello"  
          contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
          binding="basicHttpBinding" />
    </service>  
</services>  

上面的配置使客户端可以调用并获取“HelloWorld”类型的服务的元数据。

svcutil /config:Client.exe.config http://computer:8080/Hello?wsdl

使用不同的绑定值指定具有两个终结点的服务

这是最后一个示例,在本示例中,为 HelloWorld 服务类型配置了两个终结点。 每个终结点使用不同的自定义bindingConfiguration相同的绑定类型的属性 (每个修改basicHttpBinding)。

<service name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null">  
    <endpoint  
        address="http://computer:8080/Hello1"  
        contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
        binding="basicHttpBinding"  
        bindingConfiguration="shortTimeout" />
    <endpoint  
        address="http://computer:8080/Hello2"  
        contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
        binding="basicHttpBinding"  
        bindingConfiguration="Secure" />
</service>  
<bindings>  
    <basicHttpBinding   
        name="shortTimeout"  
        timeout="00:00:00:01"   
     />  
     <basicHttpBinding   
        name="Secure">  
        <Security mode="Transport" />  
     </basicHttpBinding>
</bindings>  

通过添加 protocolMapping 部分并按下面的示例所示配置绑定,可以使用默认配置获得相同的行为。

<protocolMapping>  
    <add scheme="http" binding="basicHttpBinding" bindingConfiguration="shortTimeout" />  
    <add scheme="https" binding="basicHttpBinding" bindingConfiguration="Secure" />  
</protocolMapping>  
<bindings>  
    <basicHttpBinding   
        name="shortTimeout"  
        timeout="00:00:00:01"   
     />  
     <basicHttpBinding   
        name="Secure" />  
        <Security mode="Transport" />  
</bindings>  

请参阅

历史资料。此文对应 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(示例代码)

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

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