UrlRoutingHandler Class

Reference

Definition

Namespace:: System.Web.Routing

Assembly:: System.Web.Routing.dll

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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: Object
UrlRoutingHandler

Implements: IHttpHandler

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.

Applies to

Share via