RouteCollection.MapPageRoute Method (String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)
Provides a way to define routes for Web Forms applications.
Assembly: System.Web (in System.Web.dll)
public Route MapPageRoute( string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, RouteValueDictionary defaults, RouteValueDictionary constraints, RouteValueDictionary dataTokens )
Parameters
- routeName
-
Type:
System.String
The name of the route.
- routeUrl
-
Type:
System.String
The URL pattern for the route.
- physicalFile
-
Type:
System.String
The physical URL for the route.
- checkPhysicalUrlAccess
-
Type:
System.Boolean
A value that indicates whether ASP.NET should validate that the user has authority to access the physical URL (the route URL is always checked). This parameter sets the PageRouteHandler.CheckPhysicalUrlAccess property.
- defaults
-
Type:
System.Web.Routing.RouteValueDictionary
Default values for the route parameters.
- constraints
-
Type:
System.Web.Routing.RouteValueDictionary
Constraints that a URL request must meet in order to be processed as this route.
- dataTokens
-
Type:
System.Web.Routing.RouteValueDictionary
Values that are associated with the route that are not used to determine whether a route matches a URL pattern.
| Exception | Condition |
|---|---|
| ArgumentNullException | The routeUrl parameter is null. |
This method is provided for coding convenience. It is equivalent to calling the Add method and passing a Route object that is created by using the PageRouteHandler class.
The following example shows how to define a route by using this method. This example is part of a larger example that is available in the MapPageRoute method overview.
routes.MapPageRoute("ExpenseDetailRoute", "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx", false, new RouteValueDictionary { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } }, new RouteValueDictionary { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } }, new RouteValueDictionary { { "account", "1234" }, { "subaccount", "5678" } });
Available since 4.0