<add> Element for <soapExtensionTypes> 

  • Article

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

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

group Attribute

Value Description

0

Indicates that the SOAP extension runs in the group of SOAP extensions with the highest priority.

1

Indicates that the SOAP extension runs in the group of SOAP extensions with the lowest priority.

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 Class

Concepts

SOAP Message Modification Using SOAP Extensions

Other Resources

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