IIS 和 WAS 中的基于配置的激活

在 Internet Information Services (IIS) 或 Windows Process Activation Service (WAS) 下承载 Windows Communication Foundation (WCF) 服务时,通常必须提供 .svc 文件。 .svc 文件包含该服务的名称以及可选的自定义服务主机工厂。 此附加文件将增加可管理性开销。 基于配置的激活功能不要求具有 .svc 文件,因此不会有相关开销。

基于配置的激活

基于配置的激活接受通常放置在 .svc 文件中的元数据并将其放置在 Web.config 文件中。 在 <serviceHostingEnvironment> 元素中,有一个 <serviceActivations> 元素。 <serviceActivations> 元素中包含一个或多个 <add> 元素,每个元素都对应于一项托管服务。 使用 <add> 元素包含的属性,你可以设置服务的相对地址和服务类型,或设置服务主机工厂。 下面的配置示例代码演示如何使用此节。

注意

每个 <add> 元素都必须指定一个服务属性或工厂属性。 允许同时指定服务特性和工厂特性。

<serviceHostingEnvironment>
  <serviceActivations>
    <add relativeAddress="MyServiceAddress" service="Service" factory="MyServiceHostFactory"/>
  </serviceActivations>
</serviceHostingEnvironment>

在 Web.config 文件中使用此节,你可以将服务源代码放置在应用程序的 App_Code 目录中,或者将已编译的程序集放置在应用程序的 Bin 目录中。

注意

  • 使用基于配置的激活时,不支持 .svc 文件中的内联代码。
  • 必须将 relativeAddress 属性设置为相对地址,如“<sub-directory>/service.svc”或“~/<sub-directory/service.svc”。
  • 如果注册的相对地址不具有与 WCF 关联的已知扩展,则会引发配置异常。
  • 指定的相对地址相对于虚拟应用程序的根目录。
  • 由于配置具有分层模型,因此虚拟应用程序继承计算机和站点级别的已注册相对地址。
  • 配置文件中的注册优先于 .svc、.xamlx、.xoml 或其他文件中的设置。
  • 发送到 IIS/WAS 的 URI 中的所有“\”(反斜杠)都会自动转换为“/”(正斜杠)。 如果添加的相对地址中含有“\”并且您向 IIS 发送的 URI 使用该相对地址,则反斜杠会转换为正斜杠,并且 IIS 无法将其与相对地址进行匹配。 IIS 会发出跟踪信息,指示未找到任何匹配项。

另请参阅