Export (0) Print
Expand All

UrlRoutingHandler Class

Serves as base class for classes that enable you to customize how ASP.NET routing processes a request.

System.Object
  System.Web.Routing.UrlRoutingHandler

Namespace:  System.Web.Routing
Assembly:  System.Web (in System.Web.dll)

public abstract class UrlRoutingHandler : IHttpHandler

The UrlRoutingHandler type exposes the following members.

  NameDescription
Protected methodUrlRoutingHandlerInitializes a new instance of the UrlRoutingHandler class.
Top

  NameDescription
Protected propertyIsReusableGets a value that indicates whether another request can use the UrlRoutingHandler instance.
Public propertyRouteCollectionGets or sets the collection of defined routes for the ASP.NET application.
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodProcessRequest(HttpContext)Processes an HTTP request that matches a route.
Protected methodProcessRequest(HttpContextBase)Processes an HTTP request that matches a route.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Protected methodVerifyAndProcessRequestWhen overridden in a derived class, validates the HTTP handler and performs the steps that are required to process the request.
Top

  NameDescription
Explicit interface implemetationPrivate propertyIHttpHandler.IsReusableGets a value that indicates whether another request can use the UrlRoutingHandler instance.
Explicit interface implemetationPrivate methodIHttpHandler.ProcessRequestProcesses an HTTP request that matches a route.
Top

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>

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft