Прочитать на английском

Поделиться через


Page.MasterPageFile Свойство

Определение

Получает или задает виртуальный путь эталонной страницы.

public virtual string MasterPageFile { get; set; }

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

Виртуальный путь к эталонной странице.

Исключения

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

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

-или-

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

Комментарии

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

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

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

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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