Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

чего служит ведущий символ подчеркивания в _ViewStart.html, _ViewImports.cshtml и _Layout.cshtml? Механизм визуализации Razor изначально создавался для платформы WebMatrix, где не разрешалось напрямую визуализировать файлы, имена которых начинались с символа подчеркивания. Все ключевые файлы (вроде компоновки и конфигурации) имеют имена, начинающиеся с символа подчеркивания. Это не соглашение MVC, поскольку здесь отсутствует проблема, которая была в WebMatrix, но наследие символа подчеркивания продолжает существовать.

Как упоминалось ранее, каждый контроллер получает собственный каталог внутри каталога Views, в котором хранятся его специфичные представления. Имя такого каталога совпадает с именем контроллера (без суффикса Controller). Скажем, в каталоге ViewsCars содержатся все представления для CarsController. Представления обычно именуются согласно методам действий, которые их визуализируют, хотя их имена можно изменять, как уже было показано.

Каталог Shared

Внутри каталога Views есть специальный каталог по имени Shared, в котором хранятся представления, доступные всем контроллерам и действиям. Как уже упоминалось, если запрошенный файл представления не удалось найти в каталоге, специфичном для контроллера, тогда поиск производится в каталоге Shared.

Каталог DisplayTemplates

В каталоге DisplayTemplates хранятся специальные шаблоны, которые управляют визуализацией типов, а также содействуют многократному использованию кода и согласованности отображения. Когда вызываются методы DisplayFor()/DisplayForModel(), механизм визуализации Razor ищет шаблон, имя которого совпадает с именем визуализируемого типа, например, Car.cshtml для класса Car. Если специальный шаблон найти не удалось, тогда разметка визуализируется с применением рефлексии. Поиск начинается с каталога Views{CurrentControllerName}DisplayTemplates и в случае неудачи продолжается в каталоге ViewsSharedDisplayTemplates. Методы DisplayFor()/DisplayForModel() принимают необязательный параметр, указывающий имя шаблона.

Шаблон отображения DateTime

Создайте внутри каталога ViewsShared новый каталог под названием DisplayTemplates и добавьте в него новое представление по имени DateTime.cshtml. Удалите сгенерированный код вместе с комментариями и замените его следующим кодом:

@model DateTime?

@if (Model == null)

{

  @:Unknown

}

else

{

  if (ViewData.ModelMetadata.IsNullableValueType)

  {

    @:@(Model.Value.ToString("d"))

  }

  else

  {

    @:@(((DateTime)Model).ToString("d"))

  }

}

Обратите внимание, что в директиве @model, строго типизирующей представление, используется буква m нижнего регистра. При ссылке на присвоенное значение модели в Razor применяется буква М верхнего регистра. В этом примере определение модели допускает значения null. Если переданное представлению значение для модели равно null, то шаблон отображает слово Unknown (неизвестно). В противном случае шаблон отображает дату в сокращенном формате, используя свойство Value допускающего null типа или саму модель.

Шаблон отображения Car

Создайте внутри каталога Views новый каталог по имени Cars, а внутри него — каталог под названием DisplayTemplates. Добавьте в каталог DisplayTemplates новое представление по имени Car.cshtml. Удалите сгенерированный код вместе с комментариями и замените его показанным ниже кодом, который отображает сущность Car:

@model AutoLot.Models.Entities.Car

<dl class="row">

  <dt class="col-sm-2">

    @Html.DisplayNameFor(model => model.MakeId)

  </dt>

  <dd class="col-sm-10">

    @Html.DisplayFor(model => model.MakeNavigation.Name)

  </dd>

  <dt class="col-sm-2">

    @Html.DisplayNameFor(model => model.Color)

  </dt>

  <dd class="col-sm-10">

    @Html.DisplayFor(model => model.Color)

  </dd>

  <dt class="col-sm-2">

    @Html.DisplayNameFor(model => model.PetName)

  </dt>

  <dd class="col-sm-10">

    @Html.DisplayFor(model => model.PetName)

  </dd>

</dl>

Вспомогательная функция HTML под названием DisplayNameFor() отображает имя свойства, если только свойство не декорировано или атрибутом Display(Name=""), или атрибутом DisplayName(""), и тогда применяется отображаемое значение. Метод DisplayFor() отображает значение для свойства модели, указанное в выражении. Обратите внимание, что для получения названия производителя используется навигационное свойство MakeNavigation.

Запустив приложение и перейдя на страницу RazorSyntax, вы можете быть удивлены тем, что шаблон отображения Car не применяется. Причина в том, что шаблон находится в каталоге представления Cars, а метод действия RazorSyntax и представление вызываются из HomeController. Методы действий в HomeController будут осуществлять поиск представлений в каталогах Home и Shared и потому не найдут шаблон отображения Car.

Если вы переместите файл Car.cshtml в каталог SharedDisplayTemplates, тогда представление RazorSyntax будет использовать шаблон отображения Car.

Шаблон отображения CarWithColor

Шаблон CarWithColor похож на шаблон Car. Разница в том, что этот шаблон изменяет цвет текста Color (Цвет) на основе значения свойства Color модели. Добавьте в каталог CarsDisplayTemplates новый шаблон по имени CarWithColors.cshtml и приведите разметку к следующему виду:

@model Car

<hr />

<div>

  <dl class="row">

    <dt class="col-sm-2">

      @Html.DisplayNameFor(model => model.PetName)

    </dt>

    <dd class="col-sm-10">

      @Html.DisplayFor(model => model.PetName)

    </dd>

    <dt class="col-sm-2">

      @Html.DisplayNameFor(model => model.MakeNavigation)

    </dt>

    <dd class="col-sm-10">

      @Html.DisplayFor(model => model.MakeNavigation.Name)

    </dd>

    <dt class="col-sm-2">

      @Html.DisplayNameFor(model => model.Color)

    </dt>

    <dd class="col-sm-10" style="color:@Model.Color">

      @Html.DisplayFor(model => model.Color)

    </dd>

  </dl>

</div>

Чтобы применить шаблон CarWithColors.cshtml вместо Car.cshtml, вызовите DisplayForModel() с именем шаблона (обратите внимание, что правила местоположения по-прежнему актуальны):

@Html.DisplayForModel("CarWithColors")

Каталог EditorTemplates

Каталог EditorTemplates работает аналогично каталогу DisplayTemplates, но находящиеся в нем шаблоны используются для редактирования.

Шаблон редактирования Car

Создайте внутри каталога ViewsCars новый каталог под названием EditorTemplates и добавьте в него новое представление по имени Car.cshtml. Удалите сгенерированный код вместе с комментариями и замените его показанным ниже кодом, который является разметкой для редактирования сущности Car:

@model Car

<div asp-validation-summary="All" class="text-danger"></div>

<div class="form-group">

    <label asp-for="PetName" class="col-form-label"></label>

  <input asp-for="PetName" class="form-control" />

    <span asp-validation-for="PetName" class="text-danger"></span>

</div>

<div class="form-group">

    <label asp-for="MakeId" class="col-form-label"></label>

    <select asp-for="MakeId" class="form-control" asp-items="ViewBag.MakeId">

    </select>

</div>

<div class="form-group">

    <label asp-for="Color" class="col-form-label"></label>

    <input asp-for="Color" class="form-control"/>

    <span asp-validation-for="Color" class="text-danger"></span>