Page.MasterPageFile Свойство

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Возвращает или задает виртуальный путь главной страницы.

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

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

String

Виртуальный путь главной страницы.

Исключения

InvalidOperationException

Свойство MasterPageFile задается после PreInit завершения события.

HttpException

Файл, указанный в свойстве MasterPageFile , не существует.

–или–

На странице нет Content элемента управления верхнего уровня.

Комментарии

Свойство MasterPageFile — это виртуальный путь (из корневого каталога приложения) главного файла страницы, связанного с этой страницей. Свойство MasterPageFile может быть задано только в PreInit событии; попытка задать MasterPageFile свойство после того, как PreInit событие вызовет InvalidOperationException исключение. MasterPageFile Если свойство недопустимо, исключение типа HttpException создается позже в жизненном цикле страницы, но исключение не возникает при установке свойства в событииPreInit.

Страницы с набором MasterPageFile свойств являются страницами контента, поэтому могут содержать только элементы управления верхнего уровня, которые являются Content элементами управления.

См. также раздел

• Master
• Общие сведения о главных страницах