WCF编程系列(四)配置文件

2023-02-12,,,

WCF编程系列(四)配置文件

 

.NET应用程序的配置文件

前述示例中Host项目中的App.config以及Client项目中的App.config称为应用程序配置文件,通过该文件配置可控制程序的运行时 行为,相对于在设计时通过程序来设定运行时行为,配置文件具有更高的灵活性:我们无需重新编译程序即可修改应用程序行为。编译器最终会将 App.config编译成 [应用程序名称].exe.config 文件,并放在当前应用程序目录中。而对应Web应用程序(ASP.NET)其对应的配置文件为Web.config。

.NET存在一个默认的全局配置文件Machine.config,通常位于相应.Net Framework运行库目录下的Config目录中,如:C:\Windows\Microsoft.NET\Framework \v2.0.50727\CONFIG。.NET应用程序启动时,会将应用程序下的App.config与Machine.config合并 (App.config的配置会覆盖Machine.config配置)。

.NET配置文件是一个标准的XML文件,根节点为<configuration>,在该节点下包含多个.NET的配置节点

隐藏行号 复制代码 ? C#

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
      ......
    </configuration>

WCF配置文件结构

WCF配置位于应用程序配置文件中的<system.serviceModel>节点下,其主要内容如下:

隐藏行号 复制代码 ? C#

    <system.ServiceModel>
      
      <services>
        <service>
          <endpoint/>
        </service>
      </services>
     
      <bindings>
        <binding>
        </binding>
      </bindings>
     
      <behaviors>
        <behavior>
        </behavior>
      </behaviors>
    
    
      <client>
        <endpoint/>
      </client>
    
    
    </system.ServiceModel>
    
    

<services>节点

该节点下包含应用程序承载的所有服务规范,由多个<service>节点组成。

<service>节点

一个<service>定义一个服务,该节点包含两个属性:name,指定提供服务契约实现的类型,是一个完全限定名称(即包括命名空间和类 型名称),如示例一中指定的Xfrog.Study.WCF.FirstService;behaviorConfiguration,指定服务的行为控 制配置名称,该名称和<behaviors>下<behavior>节点的name属性对应,如示例一中的 behaviorConfiguration。

<endpoint>节点

<service>节点下可包含多个<endpoint>节点,每个节点包含以下属性,用以指定终结点的地址、绑定及契约:

address属性,一个URI用以指定服务的地址,它可以是相对地址也可以是绝对地址,如果指定的是相对地址,其基地址取<service><host><baseAddresses>下定义的地址,如示例一中的定义。

binding属性,指定一个绑定,通常是WCF中预定义绑定,当然也可以指定一个自定义的绑定。

contract属性,指定一个契约,通常为通过ServiceContract特性定义的接口或类型,同样是一个完全限定名称,如示例一中的Xfrog.Study.WCF.IFirstService。

bindingConfiguration属性,如果需要修改绑定的默认行为,则需要在bindings节点下,预定义绑定对应的绑定配置节点(参见 【WCF编程系列(三)】中的预定义绑定列表)下的<binding>节点来指定,该节点的name属性和此处 bindingConfiguration属性对应,如示例一中Client项目中的绑定:

隐藏行号 复制代码 ? C#

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
      <system.serviceModel>
        <bindings>
          <basicHttpBinding> 
            <binding name="BasicHttpBinding_IFirstService" ....>
              ....
            </binding>
          </basicHttpBinding>
        </bindings>
        <client>
          <endpoint  binding="basicHttpBinding"
              bindingConfiguration="BasicHttpBinding_IFirstService" contract="IFirstService"
              name="BasicHttpBinding_IFirstService" />
        </client>
      </system.serviceModel>
    </configuration>

<endpoint>中bindingConfigration设置为BasicHttpBinding_IFirstService,对应于<bindings><basicHttpBinding><binding name="BasicHttpBinding_IFirstService"….>中的定义,而<basicHttpBinding>配置节点对应的是basicHttpBinding预定义绑定。

<client>节点

该节点用于客户端的配置,在该节点下指定客户端需调用的终结点定义。

使用WCF配置编辑器

前面示例中我们都是通过手动输入的配置内容,实际上Visual Studio 2008 为我们提供了一个WCF配置编辑器,在VS中选择工具菜单—>WCF服务配置编辑器可启动它,如果项目中已经存在App.config文件,则可直 接在该文件上单击右键,选择编辑WCF配置来启动编辑器。

WCF编程系列(四)配置文件的相关教程结束。

《WCF编程系列(四)配置文件.doc》

下载本文的Word格式文档,以方便收藏与打印。