<soapExtensionTypes> 的 <add> 元素

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

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

架构层次结构

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

语法

<add type="fully qualified type name [,Version=version number] [,Culture=culture] [,PublicKeyToken= token]"
   priority="number"
   group="0|1"/>

属性和元素

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

属性

特性 说明

type

必需的特性。

指定要添加的 SOAP 扩展类。type 特性值必须位于一行上,并且包含完全限定的类型名。当程序集放置在全局程序集缓存 (GAC) 中时,该特性值还必须包括已签名程序集的版本、区域性和公钥标记。

priority

必需的特性。

group 一起,指定当配置了多个 SOAP 扩展运行时,某个 SOAP 扩展的相对运行顺序。在每一个 group 内,由 priority 特性区分 SOAP 扩展的整体相对优先级。priority 数字越小,则指示 SOAP 扩展优先级越高。priority 特性的最小可能值是 1。

group

必需的特性。

  • priority 一起,指定当配置了多个 SOAP 扩展运行时,某个 SOAP 扩展的相对运行顺序。

子元素

无。

父元素

元素 说明

configuration

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

soapExtensionTypes

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

system.web

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

webServices

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

示例

下面的示例添加一个 SOAP 扩展类。注意,类型值必须在一行上。

<configuration>
   <system.web>
      <webServices>
         <soapExtensionTypes>
            <add type="Contoso.Extensions.MySoapExtension, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"  priority="2" group="0"/>
         </soapExtensionTypes>
      </webServices>
   </system.web>
</configuration>

另请参见

参考

<webServices> 元素
<soapExtensionTypes> 元素
SoapExtension

概念

使用 SOAP 扩展修改 SOAP 消息

其他资源

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