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.
Available since 4.0