@ Master
Определяет атрибуты, характерные для главной страницы (файла с расширением MASTER) используемые анализатором и компилятором страниц ASP.NET.
<%@ Master attribute="value" [attribute="value"...] %>
Атрибуты
Термин |
Определение |
|---|---|
AutoEventWireup |
Указывает, можно ли задать простые обработчики событий для определенных этапов жизненного цикла, используя синтаксис Page без явного подключения и сигнатур событий. Значение true, если включено автоматическое связывание; в противном случае — значение false. По умолчанию используется значение true. Дополнительные сведения см. в разделе Модель событий серверного веб-элемента управления ASP.NET. |
ClassName |
Указывает имя класса для класса, который автоматически создается из разметки и компилируется при обработке главной страницы. Этим значением может быть любое действительное имя класса, включая пространство имен. |
CodeFile |
Указывает имя отдельного файла, содержащего разделяемый класс с обработчикам события и другим кодом, ориентированным на главную страницу. Дополнительные сведения см. в разделе Модель кода веб-страниц ASP.NET. |
CompilationMode |
Указывает, нужно ли компилировать главную страницу ASP.NET во время выполнения. Можно выбрать один из следующих параметров: Always, если необходимо компилировать страницу всегда; Auto, если ASP.NET должен, по возможности, избегать компиляции страницы; и Never, если страницу или элемент управления не нужно компилировать никогда. Значение по умолчанию: Always. |
CompilerOptions |
Предоставляет строку, содержащую параметры компилятора, которые используются для компиляции страницы. Для C# и Microsoft Visual Basic эта строка представляет собой последовательность переключателей командной строки компилятора. |
Debug |
Указывает, нужно ли компилировать главную страницу с отображением символов отладки. Если параметр имеет значение true, то компилировать главную страницу с отображением символов отладки необходимо; в противном случае параметру присваивается значение false. |
Description |
Предоставляет текстовое описание главной страницы. Это значение не обрабатывается анализатором ASP.NET. |
EnableTheming |
Указывает, можно ли изменять внешний вид главной страницы и ее элементов управления, если применяется тема. Значение true, если тему можно применить; в противном случае — значение false. По умолчанию используется значение true. Настройка атрибута EnableTheming полезна, прежде всего, если тема страницы определена в файле Web.config и по умолчанию применяется ко всем файлам. Дополнительные сведения см. в разделе Темы и обложки ASP.NET. |
EnableViewState |
Определяет, сохраняется ли состояние просмотра между запросами к странице. Значение true для сохранения состояния просмотра; в противном случае — значение false. По умолчанию используется значение true. |
Explicit |
Определяет, компилируется ли страница в режиме Visual Basic Option Explicit. Значение true указывает, что включен параметр Visual Basic explicit и что все переменные должны объявляться с помощью инструкций Dim, Private, Public и ReDim; в противном случае — значение false. Значение по умолчанию: false. .gif "Примечание") Примечание
Атрибут Explicit не обрабатывается для языков, отличных от Visual Basic.
Для атрибута Explicit установлено значение true в файле Machine.config. Дополнительные сведения см. в разделе Machine Configuration Files. |
Inherits |
Определяет наследуемый страницей класс кода программной части. Им может быть любой класс, производный от класса MasterPage. Дополнительные сведения о классах кода программной части см. в разделе Общие сведения о классе страницы ASP.NET. |
Language |
Указывает язык, используемый при компиляции всех находящихся внутри страницы встроенных блоков выполнения (<% %> и <%= %>) и объявлений кода. Значение может быть любым поддерживаемым .NET Framework языком, включая VB (Visual Basic), C# и JScript. |
LinePragmas |
Определяет, должна ли среда выполнения создавать прагмы в созданном коде. |
MasterPageFile |
Указывает MASTER-файл, который используется в качестве главной страницы. Атрибут MasterPageFile используется на главной странице при определении дочерней главной страницы, если используется сценарий вложенных главных страниц. Дополнительные сведения см. в разделе Вложенные главные страницы ASP.NET. |
Src |
Указывает имя исходного файла класса кода программной части для динамической компиляции в случае запроса данной страницы. Можно выбрать использование логики программирования для страницы как в классе кода программной части, так и в Блоки объявлений кода в ASPX-файле. |
Strict |
Определяет, нужно ли компилировать страницу в режиме Visual Basic Option Strict. true, если Option Strict включен, в противном случае — false. Значение по умолчанию: false. Примечание
Атрибут Strict не обрабатывается для языков, отличных от Visual Basic.
|
WarningLevel |
Задает уровень предупреждений компилятора, при котором им будет прервана компиляция страницы. Возможные значение от 0 до 4. Дополнительные сведения см. в разделе WarningLevel. |
Заметки
Директиву @ Master можно использовать только на главных страницах. Главные страницы определены в файлах, имеющих расширение MASTER. Один MASTER-файл может содержать только одну директиву @ Master.
Пример
В следующем примере кода показывается, как настроить компилятор страниц ASP.NET так, чтобы он рассматривал Visual Basic как язык встраиваемого кода. Код обработки событий определен в разделяемом классе, имеющим имя MasterPageSample. Код для класса MasterPageSample можно найти в файле MasterPageSample.master.vb.
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>
См. также
Основные понятия
Общие сведения о синтаксисе веб-страниц ASP.NET