Web 服务设置架构

本主题专门介绍一项旧有技术。现在应通过使用以下链接来创建 XML Web 服务和 XML Web 服务客户端: Windows Communication Foundation.

Web 服务设置架构定义一些配置文件元素,这些元素控制 ASP.NET Web 服务及其客户端的行为。父元素为 <webServices>

默认情况下,<webServices> 元素及其子代应用于要应用配置的任何 Web 服务或代理类。配置是根据应用程序类型来应用的,如下所述:

  • ASP.NET Web 应用程序(服务或客户端):有关 ASP.NET Web 应用程序内的配置继承、范围和优先级的标准规则,请参阅 ASP.NET 配置文件层次结构和继承<webServices> 元素通常放置在 Web.config 文件中。

  • 独立的 .NET Framework 应用程序(仅限客户端):请参阅应用程序配置文件<webServices> 元素通常放置在应用程序配置文件中。

<webServices> 元素及其子代应用于下面几种类:

如果 Web 应用程序包含 Web 服务和客户端,则 <webServices> 元素可以同时应用于这两个实体。

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add>
            <remove>
            <clear>
         <serviceDescriptionFormatExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionImporterTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionReflectorTypes>
            <add>
            <remove>
            <clear>
         <wsdlHelpGenerator>

元素 说明

用于 <protocols><add>

添加 ASP.NET Web 服务可用来接收从客户端发送来的请求数据和返回响应数据的指定协议。

用于 <serviceDescriptionFormatExtensionTypes><add>

添加指定的服务说明格式扩展 (SDFE) 类,该类定义如何扩展为 Web 服务生成的服务说明(WSDL 文档)。

用于 <soapExtensionTypes><add>

添加指定的 SOAP 扩展类,该类在 Web 服务或客户端上提供扩展的 SOAP 消息处理。

用于 <soapExtensionImporterTypes><add>

添加指定的 SOAP 扩展导入程序类,该类扩展客户端代理的生成过程,使其可用于服务说明格式扩展 (SDFE)。

用于 <soapExtensionReflectorTypes><add>

添加指定的 SOAP 扩展发送程序类,该类用于扩展服务说明(WSDL 文档)的生成过程,使其可用于服务说明格式扩展 (SDFE)。

<clear>

移除所有对适用于父标记的项的引用。

<protocols>

指定 ASP.NET Web 服务可用来接收从客户端发送来的请求数据和返回响应数据的协议。协议可用来将请求数据与方法及其参数关联起来,以及将响应数据与方法及其返回值关联起来。

用于 <protocols><remove>

从配置文件的范围内移除用来处理请求和响应数据的指定协议。

用于 <serviceDescriptionFormatExtensionTypes><remove>

从配置文件的范围内移除指定的服务说明格式扩展 (SDFE) 类。

用于 <soapExtensionTypes><remove>

从配置文件的范围内移除指定的 SOAP 扩展类。

用于 <soapExtensionImporterTypes><remove>

从配置文件的范围内移除指定的 SOAP 扩展导入程序类。

用于 <soapExtensionReflectorTypes><remove>

从配置文件的范围内移除指定的 SOAP 扩展发送程序类。

<serviceDescriptionFormatExtensionTypes>

指定用来扩展为 Web 服务生成的 WSDL 文档的服务说明格式扩展 (SDFE) 类。SDFE 类提供一种描述 SOAP 扩展的方法。

<soapExtensionImporterTypes>

指定 SOAP 扩展导入程序类,这些类用于扩展客户端代理的生成过程。适用于服务说明格式扩展 (SDFE)。

<soapExtensionReflectorTypes>

指定 SOAP 扩展发送程序类,这些类用于扩展服务说明(WSDL 文档)的生成过程。适用于服务说明格式扩展 (SDFE)。

<soapExtensionTypes>

指定在 Web 服务或客户端上进行处理的过程中用来检查或修改 SOAP 消息的 SOAP 扩展。SOAP 扩展扩充了 Web 服务的功能。

<webServices>

控制使用 ASP.NET 部署的 Web 服务的设置以及运行在 .NET Framework 上的 Web 服务客户端的设置。

<wsdlHelpGenerator>

指定 Web 服务帮助页(.aspx 文件),该帮助页在浏览器直接定位到 ASMX Web 服务页时显示给该浏览器。

另请参见

其他资源

ASP.NET Settings Schema
使用 ASP.NET 创建的 XML Web Services 以及 XML Web Services 客户端