UrlRoutingHandler Class
Definition
Serves as base class for classes that enable you to customize how ASP.NET routing processes a request.
public ref class UrlRoutingHandler abstract : System::Web::IHttpHandler
public abstract class UrlRoutingHandler : System.Web.IHttpHandler
type UrlRoutingHandler = class
interface IHttpHandler
Public MustInherit Class UrlRoutingHandler
Implements IHttpHandler
- Inheritance
-
UrlRoutingHandler
- Implements
Remarks
You can customize how ASP.NET routing handles requests by mapping a file name extension to a particular routing handler instead of by using the UrlRoutingModule class as the routing handler for every request.
To customize how ASP.NET routing handles a request for a URL with a specific file name extension, you create a class that derives from the UrlRoutingHandler class. For example, you can create a customized routing handler that processes requests for a file that has the extension .abc
.
To register a customized handler for a particular file name extension, you must add that handler in the Web.config file. The following example shows how to register a customized handler for an ASP.NET Web site that is running in IIS 6.0 or IIS 7.0 in Classic mode.
<system.web>
<httpHandlers>
<add verb="*" path="*.abc"
type="Contoso.Routing.CustomRoutingHandler" />
</httpHandlers>
</system.web>
The following example shows how to register the same handler for an ASP.NET Web site that is running in IIS 7.0.
<system.webServer>
<handlers>
<add verb="*" path="*.abc"
type="Contoso.Routing.CustomRoutingHandler"
resourceType="Unspecified" />
</handlers>
</system.webServer>
Constructors
UrlRoutingHandler() |
Initializes a new instance of the UrlRoutingHandler class. |
Properties
IsReusable |
Gets a value that indicates whether another request can use the UrlRoutingHandler instance. |
RouteCollection |
Gets or sets the collection of defined routes for the ASP.NET application. |
Methods
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
GetType() |
Gets the Type of the current instance. (Inherited from Object) |
MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
ProcessRequest(HttpContext) |
Processes an HTTP request that matches a route. |
ProcessRequest(HttpContextBase) |
Processes an HTTP request that matches a route. |
ToString() |
Returns a string that represents the current object. (Inherited from Object) |
VerifyAndProcessRequest(IHttpHandler, HttpContextBase) |
When overridden in a derived class, validates the HTTP handler and performs the steps that are required to process the request. |
Explicit Interface Implementations
IHttpHandler.IsReusable |
Gets a value that indicates whether another request can use the UrlRoutingHandler instance. |
IHttpHandler.ProcessRequest(HttpContext) |
Processes an HTTP request that matches a route. |