<soapExtensionImporterTypes> 的 <add> 元素

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

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

架构层次结构

<configuration>
  <system.web>
    <webServices> 元素
      <soapExtensionImporterTypes> 元素
        <soapExtensionImporterTypes> 的 <add> 元素

语法

<add type="soap extension class" 
     priority="number"
     group="0|1"/>

属性和元素

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

属性

特性	说明
type	必需的特性。 指定要添加的 SOAP 扩展导入程序类。
priority	必需的特性。 与 group 一起，指定当配置了多个 SOAP 扩展导入程序运行时，某个 SOAP 扩展导入程序的相对运行顺序。在每一个 group 内，priority 特性都区分 SOAP 扩展导入程序的整体相对优先级。priority 的数字越小，表示 SOAP 扩展导入程序的优先级越高。priority 特性的最小可能值是 1。
group	必需的特性。 与 priority 一起，指定当配置了多个 SOAP 扩展导入程序运行时，某个 SOAP 扩展导入程序的相对运行顺序。可能值如下： 0：指示该 SOAP 扩展导入程序在 SOAP 扩展导入程序组中的运行优先级最高。 1：指示该 SOAP 扩展导入程序在 SOAP 扩展导入程序组中的运行优先级最低。

子元素

无。

父元素

元素	说明
configuration	公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
soapExtensionImporterTypes	指定仅适用于 Web 服务客户端的 SOAP 扩展导入程序类，这些类用于扩展客户端代理的生成过程。
system.web	为 ASP.NET 配置节指定根元素。
webServices	控制使用 ASP.NET 部署的 Web 服务的设置以及运行在 .NET Framework 上的 Web 服务客户端的设置。

示例

下面的示例添加一个 SOAP 扩展导入程序类。

<system.web>
   <webServices>
      <soapExtensionImporterTypes>
         <add type="MyImporter priority="2" group="0"/>
      </soapExtensionImporterTypes>
   </webServices>
</system.web>

另请参见

任务

演练：自定义服务说明和代理类的生成

参考

<webServices> 元素
<soapExtensionImporterTypes> 元素
SoapExtensionImporter

其他资源

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