PageRouteHandler Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the PageRouteHandler class.
Overloads
PageRouteHandler(String) |
Initializes a new instance of the PageRouteHandler class. |
PageRouteHandler(String, Boolean) |
Initializes a new instance of the PageRouteHandler class. |
PageRouteHandler(String)
Initializes a new instance of the PageRouteHandler class.
public:
PageRouteHandler(System::String ^ virtualPath);
public PageRouteHandler (string virtualPath);
new System.Web.Routing.PageRouteHandler : string -> System.Web.Routing.PageRouteHandler
Public Sub New (virtualPath As String)
Parameters
- virtualPath
- String
The virtual path of the physical file for this Route object. The file must be located in the current application. Therefore, the path must begin with a tilde (~).
Exceptions
The virtualPath
parameter is null
or is an empty string or does not start with "~/".
Remarks
When you use this constructor, the CheckPhysicalUrlAccess property is set to true
.
See also
- Route
- ASP.NET Routing
- How to: Define Routes for Web Forms Applications
- Walkthrough: Using ASP.NET Routing in a Web Forms Application
Applies to
PageRouteHandler(String, Boolean)
Initializes a new instance of the PageRouteHandler class.
public:
PageRouteHandler(System::String ^ virtualPath, bool checkPhysicalUrlAccess);
public PageRouteHandler (string virtualPath, bool checkPhysicalUrlAccess);
new System.Web.Routing.PageRouteHandler : string * bool -> System.Web.Routing.PageRouteHandler
Public Sub New (virtualPath As String, checkPhysicalUrlAccess As Boolean)
Parameters
- virtualPath
- String
The virtual path of the physical file of this Route object. The file must be located in the current application. Therefore, the path must begin with a tilde (~).
- checkPhysicalUrlAccess
- Boolean
If this property is set to false
, authorization rules will be applied to the request URL and not to the URL of the physical page. If this property is set to true
, authorization rules will be applied to both the request URL and to the URL of the physical page.
Exceptions
The virtualPath
parameter is null
or is an empty string or does not start with "~/".
Remarks
By default, the CheckPhysicalUrlAccess property is true
. Therefore, if you want authorization rules to be applied to both the URL of the physical page and to the route URL, you can use the PageRouteHandler(String) constructor instead of this constructor.
See also
- CheckPhysicalUrlAccess
- Route
- ASP.NET Routing
- How to: Define Routes for Web Forms Applications
- Walkthrough: Using ASP.NET Routing in a Web Forms Application