Page.MasterPageFile Свойство

Определение

Получает или задает виртуальный путь эталонной страницы.Gets or sets the virtual path of the master page.

public:
 virtual property System::String ^ MasterPageFile { System::String ^ get(); void set(System::String ^ value); };
public virtual string MasterPageFile { get; set; }
member this.MasterPageFile : string with get, set
Public Overridable Property MasterPageFile As String

Значение свойства

Виртуальный путь к эталонной странице.The virtual path of the master page.

Исключения

Свойство MasterPageFile устанавливается после завершения события PreInit.The MasterPageFile property is set after the PreInit event is complete.

Файл, указанный в свойстве MasterPageFile, не существует.The file specified in the MasterPageFile property does not exist.

- или --or- Страница не имеет элемента управления Content на верхнем уровне.The page does not have a Content control as the top level control.

Комментарии

Свойство MasterPageFile — это виртуальный путь (от корня приложения) файла главной страницы, связанного с этой страницей.The MasterPageFile property is a virtual path (from the root of the application) of the master page file associated with this page. Свойство MasterPageFile может быть задано только в событии PreInit; попытка задать свойство MasterPageFile после события PreInit выдаст исключение InvalidOperationException.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. Если свойство MasterPageFile недопустимо, исключение типа HttpException возникает позже в жизненном цикле страницы, но исключение не создается, если свойство задано в событии PreInit.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.

Страницы, для которых задано свойство MasterPageFile, являются страницами содержимого и, следовательно, могут содержать только элементы управления верхнего уровня, которые являются Content элементами управления.Pages that have the MasterPageFile property set are content pages, and therefore can contain only top-level controls that are Content controls.

Применяется к

Дополнительно