Кроме html-хелперов форм, которые создают различные элементы формы, фреймворк ASP.NET Core MVC также имеет шаблонные (или шаблонизированные) хелперы. В отличие от рассмотренных в прошлой главе html-хелперов они не генерируют определенный элемент html. Шаблонные хелперы смотрят на свойство модели и генерируют тот элемент html, который наиболее подходит данному свойству, исходя из его типа и метаданных.
В ASP.NET MVC имеются следующие шаблонные хелперы:
Display
Создает элемент разметки для отображения значения указанного свойства модели:
Html.Display("Name")
DisplayFor
Строго типизированный аналог хелпера Display:
Html.DisplayFor(m => m.Name)
Editor
Создает элемент разметки для редактирования указанного свойства модели:
Html.Editor("Name")
EditorFor
Строго типизированный аналог хелпера Editor:
Html.EditorFor(m => m.Name)
DisplayText
Создает выражение для указанного свойства модели в виде простой строки:
Html.DisplayText("Name")
DisplayTextFor
Строго типизированный аналог хелпера DisplayText:
Html.DisplayTextFor(m => m.Name)
Это были одиночные хелперы, которые генерируют разметку только для одного свойства модели. Но кроме них во фреймворке также есть еще несколько шаблонов, которые позволяют создать разом все поля для всех свойств модели:
DisplayForModel
Создает поля для чтения для всех свойств модели:
Html.DisplayForModel()
DisplayTextForModel
Создает поля для чтения для всех свойств модели в виде строки
EditorForModel
Создает поля для редактирования для всех свойств модели:
Html.EditorForModel()
Например, пусть у нас есть стандартная модель User:
public record class User(int Id, string Name, int Age);
Пусть в методе контроллера передается объект этой модели в представление:
public IActionResult Details() { User tom = new User(1, "Tom", 37); return View(tom); }
И для вывода данных используем в представлении хелпер Html.Display
:
@model MvcApp.Models.User <p> <b>Id:</b><br /> @Html.Display("Id") </p> <p> <b>Имя:</b><br /> @Html.Display("Name") </p> <p> <b>Возраст:</b><br /> @Html.Display("Age") </p>
Аналогичный вывод мы могли бы сделать, применив строго типизированную версию хелпера:
@model HtmlHelpersApp.Models.User <p> <b>Id:</b><br /> @Html.DisplayFor(u=>u.Id) </p> <p> <b>Имя:</b><br /> @Html.DisplayFor(u=>u.Name) </p> <p> <b>Возраст:</b><br /> @Html.DisplayFor(u=>u.Age) </p>
Либо можно было бы вывести все данные разом:
@Html.DisplayForModel()
Html.Editor работает во многом аналогично. Допустим, у нас есть действие, которое принимает объект модели User:
[HttpGet] public IActionResult Create() => View(); [HttpPost] public string Create(User user) => $"{user.Name} - {user.Age}";
Тогда мы могли бы определить следующую форму:
@model MvcApp.Models.User @using (Html.BeginForm("Create", "Home", FormMethod.Post)) { <p> @Html.LabelFor(m=>m.Name, "Имя")<br /> @Html.Editor("Name") </p> <p> @Html.LabelFor(m => m.Age, "Возраст")<br /> @Html.EditorFor(m => m.Age) </p> <p> <input type="submit" value="Отправить" /> </p> }
Что важно, хелпер Html.Editor
смотрит на тип свойства и на основании типа генерирует то или иное поле. Например, для свойства Age
будет сгенерировано поле <input type="number" />
. И если в прошлой теме нам явным образом приходилось указывать тип для Html.TextBox:
@Html.TextBoxFor(m=>m.Age, "", new { type = "number" })
Здесь это хелпер сделает автоматически.