remove Element for httpHandlers (ASP.NET Settings Schema)
Removes a verb/path mapping to an IHttpHandler interface.
<configuration> Element
system.web Element (ASP.NET Settings Schema)
httpHandlers Element (ASP.NET Settings Schema)
remove Element for httpHandlers (ASP.NET Settings Schema)
<remove verb="[verb list]" path-"path"/>
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute |
Description |
|---|---|
verb |
Required attribute. Specifies the verb list that matches the verb list of the handler to remove. |
path |
Required attribute. Specifies the path that matches the path of the handler to remove. |
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
configuration |
Specifies the required root element in every configuration file that is used by the common language runtime and the .NET Framework applications. |
system.web |
Specifies the root element for the ASP.NET configuration section. |
httpHandlers |
Maps incoming requests to the appropriate handler, according to the URL and the HTTP verb that are specified in the request. |
Remarks
The remove directive must exactly match the verb/path mapping of a previous <add> directive. Wildcard characters are not supported.
Example
The following code example demonstrates how to remove all handler mappings to SOAP handlers.
<configuration>
<system.web>
<httpHandlers>
<remove verb="*" path="*.soap"/>
</httpHandlers>
</system.web>
</configuration>
Element Information
Configuration section handler |
|
Configuration member |
|
Configurable locations |
Machine.config Root-level Web.config Application-level Web.config Virtual or physical directory–level Web.config |
Requirements |
Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0 The .NET Framework version 1.0, 1.1, or 2.0 Microsoft Visual Studio 2003 or Visual Studio 2005 |
See Also
Tasks
How to: Lock ASP.NET Configuration Settings
Reference
httpHandlers Element (ASP.NET Settings Schema)
system.web Element (ASP.NET Settings Schema)
add Element for httpHandlers (ASP.NET Settings Schema)
clear Element for httpHandlers (ASP.NET Settings Schema)
Concepts
ASP.NET Configuration Overview
ASP.NET Web Server Controls and Browser Capabilities
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios
Other Resources
ASP.NET Configuration Settings