UrlRoutingHandler Class
Serves as base class for classes that enable you to customize how ASP.NET routing processes a request.
Assembly: System.Web (in System.Web.dll)
The UrlRoutingHandler type exposes the following members.
| Name | Description | |
|---|---|---|
|
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. |
| Name | Description | |
|---|---|---|
|
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
|
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
|
|
GetHashCode | Serves as a hash function for a particular type. (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 | When overridden in a derived class, validates the HTTP handler and performs the steps that are required to process the request. |
| Name | Description | |
|---|---|---|
|
IHttpHandler.IsReusable | Gets a value that indicates whether another request can use the UrlRoutingHandler instance. |
|
IHttpHandler.ProcessRequest | Processes an HTTP request that matches a route. |
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>
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
