<add> Element for <soapExtensionTypes>

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

    <webServices> Element
      <soapExtensionTypes> Element
        <add> Element for <soapExtensionTypes>


<add type="fully qualified type name [,Version=version number] [,Culture=culture] [,PublicKeyToken= token]"

Attributes and Elements

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


Attribute Description


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.


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.


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


Parent Elements

Element Description


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


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.


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


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


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

            <add type="Contoso.Extensions.MySoapExtension, Version=, Culture=neutral, PublicKeyToken=31bf3856ad364e35"  priority="2" group="0"/>

See Also


<webServices> Element
<soapExtensionTypes> Element


SOAP Message Modification Using SOAP Extensions

Other Resources

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