Данное руководство устарело. Актуальное руководство: Руководство по 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, дописывая его
определение в начало представления.