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的配置节点
-
<?xml version="1.0" encoding="utf-8"?>
-
<configuration>
-
......
-
</configuration>
WCF配置文件结构
WCF配置位于应用程序配置文件中的<system.serviceModel>节点下,其主要内容如下:
-
<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项目中的绑定:
-
<?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配置来启动编辑器。
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· go语言实现终端里的倒计时
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· 周边上新:园子的第一款马克杯温暖上架
· Open-Sora 2.0 重磅开源!
· 分享 3 个 .NET 开源的文件压缩处理库,助力快速实现文件压缩解压功能!
· Ollama——大语言模型本地部署的极速利器
· DeepSeek如何颠覆传统软件测试?测试工程师会被淘汰吗?