Route Constructors

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Initializes a new instance of the Route class.

Overloads

Route(String, IRouteHandler)	Initializes a new instance of the Route class, by using the specified URL pattern and handler class.
Route(String, RouteValueDictionary, IRouteHandler)	Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, and handler class.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, and handler class.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, custom values, and handler class.

Route(String, IRouteHandler)

Initializes a new instance of the Route class, by using the specified URL pattern and handler class.

public:
 Route(System::String ^ url, System::Web::Routing::IRouteHandler ^ routeHandler);

public Route (string url, System.Web.Routing.IRouteHandler routeHandler);

new System.Web.Routing.Route : string * System.Web.Routing.IRouteHandler -> System.Web.Routing.Route

Public Sub New (url As String, routeHandler As IRouteHandler)

Parameters

url

String

The URL pattern for the route.

routeHandler

IRouteHandler

The object that processes requests for the route.

Examples

The following example shows how to create a Route object and add it to the Routes property.

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

public static void RegisterRoutes(RouteCollection routes)
{
    routes.Add(new Route
    (
         "Category/{action}/{categoryName}"
         , new CategoryRouteHandler()
    ));
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
    Dim urlPattern As String
    Dim categoryRoute As Route
    
    urlPattern = "Category/{action}/{categoryName}"
    
    categoryRoute = New Route(urlPattern, New CategoryRouteHandler)
    
    routes.Add(categoryRoute)
End Sub

See also

• ASP.NET Routing

Route(String, RouteValueDictionary, IRouteHandler)

Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, and handler class.

public:
 Route(System::String ^ url, System::Web::Routing::RouteValueDictionary ^ defaults, System::Web::Routing::IRouteHandler ^ routeHandler);

public Route (string url, System.Web.Routing.RouteValueDictionary defaults, System.Web.Routing.IRouteHandler routeHandler);

new System.Web.Routing.Route : string * System.Web.Routing.RouteValueDictionary * System.Web.Routing.IRouteHandler -> System.Web.Routing.Route

Public Sub New (url As String, defaults As RouteValueDictionary, routeHandler As IRouteHandler)

Parameters

url

String

The URL pattern for the route.

defaults

RouteValueDictionary

The values to use for any parameters that are missing in the URL.

routeHandler

IRouteHandler

The object that processes requests for the route.

See also

• Defaults
• ASP.NET Routing

Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, and handler class.

public:
 Route(System::String ^ url, System::Web::Routing::RouteValueDictionary ^ defaults, System::Web::Routing::RouteValueDictionary ^ constraints, System::Web::Routing::IRouteHandler ^ routeHandler);

public Route (string url, System.Web.Routing.RouteValueDictionary defaults, System.Web.Routing.RouteValueDictionary constraints, System.Web.Routing.IRouteHandler routeHandler);

new System.Web.Routing.Route : string * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary * System.Web.Routing.IRouteHandler -> System.Web.Routing.Route

Public Sub New (url As String, defaults As RouteValueDictionary, constraints As RouteValueDictionary, routeHandler As IRouteHandler)

Parameters

url

String

The URL pattern for the route.

defaults

RouteValueDictionary

The values to use if the URL does not contain all the parameters.

constraints

RouteValueDictionary

A regular expression that specifies valid values for a URL parameter.

routeHandler

IRouteHandler

The object that processes requests for the route.

See also

• Constraints
• Defaults
• ASP.NET Routing

Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, custom values, and handler class.

public:
 Route(System::String ^ url, System::Web::Routing::RouteValueDictionary ^ defaults, System::Web::Routing::RouteValueDictionary ^ constraints, System::Web::Routing::RouteValueDictionary ^ dataTokens, System::Web::Routing::IRouteHandler ^ routeHandler);

public Route (string url, System.Web.Routing.RouteValueDictionary defaults, System.Web.Routing.RouteValueDictionary constraints, System.Web.Routing.RouteValueDictionary dataTokens, System.Web.Routing.IRouteHandler routeHandler);

new System.Web.Routing.Route : string * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary * System.Web.Routing.IRouteHandler -> System.Web.Routing.Route

Public Sub New (url As String, defaults As RouteValueDictionary, constraints As RouteValueDictionary, dataTokens As RouteValueDictionary, routeHandler As IRouteHandler)

Parameters

url

String

The URL pattern for the route.

defaults

RouteValueDictionary

The values to use if the URL does not contain all the parameters.

constraints

RouteValueDictionary

A regular expression that specifies valid values for a URL parameter.

dataTokens

RouteValueDictionary

Custom values that are passed to the route handler, but which are not used to determine whether the route matches a specific URL pattern. These values are passed to the route handler, where they can be used for processing the request.

routeHandler

IRouteHandler

The object that processes requests for the route.

See also

• Constraints
• DataTokens
• Defaults
• ASP.NET Routing