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
• Основные сведения о главных страницах