Page.MasterPageFile Property
Gets or sets the virtual path of the master page.
Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)
| Exception | Condition |
|---|---|
| InvalidOperationException | The MasterPageFile property is set after the PreInit event is complete. |
| HttpException | The file specified in the MasterPageFile property does not exist. - or - The page does not have a Content control as the top level control. |
The MasterPageFile property is a virtual path (from the root of the application) of the master page file associated with this page. The MasterPageFile property can be set only in the PreInit event; attempting to set the MasterPageFile property after the PreInit event will throw an InvalidOperationException exception. If the MasterPageFile property is not valid, an exception of type HttpException is thrown later in the page life cycle, but no exception is thrown when the property is set in the PreInit event.
Pages that have the MasterPageFile property set are content pages, and therefore can contain only top-level controls that are Content controls.
| Topic | Location |
|---|---|
| How to: Reference ASP.NET Master Page Content | Building ASP .NET Web Applications |
| How to: Reference ASP.NET Master Page Content | Building ASP .NET Web Applications |
| How to: Create Content Pages for an ASP.NET Master Page (Visual Studio) | Building ASP .NET Web Applications in Visual Studio |
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.