<add> Element for <httpHandlers>

Article
09/13/2006

Specifies that the WSE SOAP router runs for a Web application.

<add verb="*" path="*.asmx"
  type="Microsoft.Web.Services3.Messaging.SoapHttpRouter,
  Microsoft.Web.Services3, Version=3.0.0.0,
  Culture=neutral,
  PublicKeyToken=31bf3856ad364e35" />

Attributes and Elements

Attributes

Attribute	Description
verb	Required attribute. The verb list can be either a comma-separated list of HTTP verbs (for example, "GET, PUT, POST") or a start-script mapping (for example, the wildcard character * [an asterisk]).
path	Required attribute. The path attribute can contain either a single URL path or a simple wildcard string. When you are Setting the path attribute to "*.asmx" specifies that any request that is received for an XML Web service created using ASP.NET is sent to the security token service or WSE router first.
type	Required attribute. The type for the WSE router. The name and strong-named assembly it is contained in must appear on one line.

Child Elements

None

Parent Elements

Element	Description
<httpHandlers>	Maps incoming requests to the appropriate IHttpHandler or IHttpHandlerFactory class, according to the URL and the HTTP verb specified in the request.

Remarks

To use the routing features of WSE, you must add this entry to the Web.config of the computer acting as a SOAP message router. For details, about using the WSE router, see Routing SOAP Messages with WSE.

Example

The following code example configures the WSE router to run for all SOAP requests that are received for files with an .asmx extension in this Web application.

<configuration>
    <system.web>
        <httpHandlers>
            <add verb="*" path="*.asmx"
                type="Microsoft.Web.Services3.Messaging.SoapHttpRouter,
                    Microsoft.Web.Services3, Version=3.0.0.0,
                    Culture=neutral,
                    PublicKeyToken=31bf3856ad364e35" />
        </httpHandlers>
    </system.web>
</configuration>