<add> Element for <soapExtensionTypes>

  • Article

This topic is specific to a legacy technology. XML Web services and XML Web service clients should now be created using Windows Communication Foundation.

Adds a specified SOAP extension class that provides extended processing of SOAP messages on the Web service or client.

Schema Hierarchy

<configuration>
  <system.web>
    <webServices> Element
      <soapExtensionTypes> Element
        <add> Element for <soapExtensionTypes>

Syntax

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

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description

type

Required attribute.

Specifies the SOAP extension class to add. The type attribute value must be on one line, and include the fully qualified type name. When the assembly is placed in the Global Assembly Cache (GAC), it must also include the version, culture and public key token of the signed assembly.

priority

Required attribute.

Along with group, specifies the relative order in which a SOAP extension runs when multiple SOAP extensions are configured to run. Within each group, the priority attribute distinguishes the overall relative priority of the SOAP extension. A lower priority number indicates a higher priority for the SOAP extension. The lowest possible value for the priority attribute is 1.

group

Required attribute.

  • Along with priority, specifies the relative order in which a SOAP extension runs when multiple SOAP extensions are configured to run.

Child Elements

None.

Parent Elements

Element Description

configuration

The root element in every configuration file used by the common language runtime and .NET Framework applications.

soapExtensionTypes

Specifies the SOAP extensions used to inspect or modify the SOAP message during processing on the Web service or client. SOAP extensions augment the functionality of Web services.

system.web

Specifies the root element for the ASP.NET configuration section.

webServices

Controls the settings of Web services deployed using ASP.NET and of Web service clients running on the .NET Framework.

Example

The following example adds a SOAP extension class. Note that the type value must be on one line.

<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>

See Also

Reference

<webServices> Element
<soapExtensionTypes> Element
SoapExtension

Concepts

SOAP Message Modification Using SOAP Extensions

Other Resources

ASP.NET Settings Schema
XML Web Services Created Using ASP.NET and XML Web Service Clients