Данное руководство устарело. Актуальное руководство: Руководство по ASP.NET Core
Мастер-страницы используются для создания единообразного, унифицированного вида сайта. По сути мастер-страницы - это те же самые представления, но позволяющие включать в себя другие представления. Например, можно определить на мастер-странице общие для всех остальных представлений элементы, а также подключить общие стили и скрипты. В итог нам не придется на каждом отдельном представлении прописывать путь к файлам стилей, а потом при необходимости его изменять. А используемые на мастер-страницах заполнители или плейсхолдеры позволят вставить на их место другие представления.
По умолчанию при создании нового проекта ASP.NET MVC 5 в проект уже добавляется мастер-страница под названием _Layout.chtml, которую можно найти в каталоге Views/Shared. В приложении из второй главы мы ее изменили следующим образом:
<!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <title>@ViewBag.Title</title> <link href="@Url.Content("~/Content/Site.css")" rel="stylesheet" type="text/css" /> </head> <body> <nav> <ul class="menu"> <li>@Html.ActionLink("Главная", "Index", "Home")</li> </ul> </nav> @RenderBody() </body> </html>
На первый взгляд это обычное представление за одним исключением: здесь используется метод @RenderBody()
, который является заместителем и на место которого
потом будут подставляться другие представления, использующие данную мастер-страницу. В итоге мы
сможем легко установить для представлений веб-приложения единообразный стиль.
Чтобы в представлении использовать мастер-страницу, нам надо в секции Layout указать путь к нужной мастер-странице. Например, в представлении Index.cshtml можно определить мастер-страницу так:
@{ Layout = "~/Views/Shared/_Layout.cshtml"; }
Если мы не используем мастер-страницу, то указываем Layout = null;
.
Также необязательно для всех представлений использовать одну и ту же мастер-страницу. Можно определить несколько мастер-страниц, например, одну для форума, одну для блога и т.д., и в зависимости от раздела сайта подключать нужную. Добавляются в проект они также как и обычные представления.
Мастер-страница может иметь несколько секций, куда представления могут поместить свое содержимое. Например, добавим к мастер-странице секцию footer:
<!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <title>@ViewBag.Title</title> <link href="@Url.Content("~/Content/Site.css")" rel="stylesheet" type="text/css" /> </head> <body> <nav> <ul class="menu"> <li>@Html.ActionLink("Главная", "Index", "Home")</li> </ul> </nav> @RenderBody() <footer>@RenderSection("Footer")</footer> </body> </html>
Теперь при запуске предыдущего представления Index мы получим ошибку, так как секция Footer не определена.
По умолчанию представление должно передавать содержание для каждой секции мастер-страницы.
Поэтому добавим вниз представления Index секцию footer. Это мы можем сделать с помощью выражения @section
:
@{ Layout = "~/Views/Shared/_Layout.cshtml"; } <!-- здесь остальное содержание --> @section Footer { Все права защищены. Syte Corp. 2012. }
Но при таком подходе, если у нас есть куча представлений, и мы вдруг захотели определить новую секцию на мастер-странице, нам придется изменить все имеющиеся представления, что не очень удобно. В этом случае мы можем воспользоваться одним из вариантов гибкой настройки секций.
Первый вариант заключается в использовании перегруженной версии метода RenderSection, которая позволяет указать, что данную секцию
не обязательно определять в представлении. Чтобы отметить секцию Footer
в качестве необязательной, надо передать в метод
в качестве второго параметра значение false
:
<footer>@RenderSection("Footer", false)</footer>
Второй вариант позволяет задать содержание секции по умолчанию, если данная секция не определена в представлении:
<footer> @if (IsSectionDefined("Footer")) { @RenderSection("Footer") } else { <span>Содержание элемента footer по умолчанию.</span> } </footer>
Если у нас в проекте пара-тройка представлений, мы легко можем изменить вручную для каждого описание мастер-страницы в секции Layout, если, например, мы решим использовать другую мастер-страницу. Но если у нас много представлений, то это делать будет не очень удобно.
Для более гибкой настройки представлений предназначена страница _ViewStart.cshtml
.
Код этой страницы выполняется до кода любого из представлений, расположенных в том же каталоге. Данный файл последовательно применяется
к каждому представлению, находящемуся в одном каталоге.
При создании проекта ASP.NET MVC 5 в каталог Views уже по умолчанию добавляется файл _ViewStart.cshtml
.
Этот файл определяет мастер-страницу, используемую по умолчанию:
@{ Layout = "~/Views/Shared/_Layout.cshtml"; }
Данный код выполняется до любого другого кода, определенного в представлении, поэтому из других представлений мы можем удалить секцию Layout
.
Если же представление должно использовать другую мастер-страницу, то мы просто переопределяем свойство Layout
, дописывая его
определение в начало представления.