通过

<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 客户端