StopRoutingHandler Class (System.Web.Routing)

.NET Framework Class Library

StopRoutingHandler Class

Provides a way to specify that ASP.NET routing should not handle requests for a URL pattern.

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

Syntax

Visual Basic (Declaration)

<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class StopRoutingHandler _
    Implements IRouteHandler

Visual Basic (Usage)

Dim instance As StopRoutingHandler

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class StopRoutingHandler : IRouteHandler

Visual C++

[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class StopRoutingHandler : IRouteHandler

JScript

public class StopRoutingHandler implements IRouteHandler

Remarks

The StopRoutingHandler class enables you to specify that ASP.NET routing should not handle certain URL requests. You prevent routing from handling certain requests by defining a route and specifying that the StopRoutingHandler class should be used to handle that route's pattern. When a request is handled by a StopRoutingHandler object, the StopRoutingHandler object blocks any additional processing of the request as a route. Instead, the request is processed as an ASP.NET page, Web service, or other ASP.NET endpoint.

Examples

The following example shows how to prevent routing from handling requests for .axd requests.

Visual Basic

routes.Add(New Route("{resource}.axd/{*pathInfo}", New StopRoutingHandler()))

routes.Add(new Route("{resource}.axd/{*pathInfo}", new StopRoutingHandler()));

Inheritance Hierarchy

System..::.Object
System.Web.Routing..::.StopRoutingHandler

Thread Safety

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

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

Version Information

.NET Framework

Supported in: 3.5 SP1

Reference

StopRoutingHandler Members

System.Web.Routing Namespace