Share via

<webServices> 元素

  • 项目

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

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

架构层次结构

<configuration>
  <system.web>
    <webServices> 元素

语法

<webServices> 
   <protocols> 
      <add name="protocol name"/>
      <remove name="protocol name"/>
      <clear/>
   </protocols>
   <serviceDescriptionFormatExtensionTypes> 
      <add type="type"/>
      <remove type="type"/>
      <clear/>
   </serviceDescriptionFormatExtensionTypes>
   <soapExtensionTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionTypes>
   <soapExtensionReflectorTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionReflectorTypes>
   <soapExtensionImporterTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionImporterTypes>
   <wsdlHelpGenerator href="help generator file"/>
   <diagnostics suppressReturningExceptions="true|false" />
</webServices>

属性和元素

以下几节描述了特性、子元素和父元素。

属性

无。

子元素

子元素 说明

diagnostics

指定是否要将异常返回客户端以用于调试目的。

protocols

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

serviceDescriptionFormatExtensionTypes

指定要在配置文件的范围内运行的服务描述格式扩展。

soapExtensionTypes

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

soapExtensionReflectorTypes

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

soapExtensionImporterTypes

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

wsdlHelpGenerator

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

父元素

元素 说明

configuration

公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

system.web

为 ASP.NET 配置节指定根元素。

示例

下面的示例指定 XML Web services 配置设置。

<configuration>
   <system.web>
      <webServices>
         <diagnostics suppressReturningExceptions="false"/>
         <protocols>
            <add name="HttpGet"/>
            <add name="HttpPost"/>
            <add name="Documentation"/>
         </protocols>
         <serviceDescriptionFormatExtensionTypes>
         </serviceDescriptionFormatExtensionTypes>
         <soapExtensionTypes>
         </soapExtensionTypes>
         <soapExtensionReflectorTypes>
         </soapExtensionReflectorTypes>
         <soapExtensionImporterTypes>
         </soapExtensionImporterTypes>
         <wsdlHelpGenerator href="DefaultSdlHelpGenerator.aspx"/>
      </webServices>
   </system.web>
</configuration>

另请参见

参考

Web 服务设置架构

其他资源

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