Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен
using AutoLot.Mvc.Controllers;
using AutoLot.Mvc.TagHelpers.Base;
using Microsoft.AspNetCore.Mvc.Infrastructure;
using Microsoft.AspNetCore.Mvc.Routing;
using Microsoft.AspNetCore.Razor.TagHelpers;
namespace AutoLot.Mvc.TagHelpers
{
public class ItemListTagHelper : ItemLinkTagHelperBase
{
}
}
Добавьте открытый конструктор, который принимает обязательные экземпляры и передает их конструктору базового класса:
public ItemListTagHelper(
IActionContextAccessor contextAccessor,
IUrlHelperFactory urlHelperFactory)
: base(contextAccessor, urlHelperFactory) {}
Переопределите метод Process(), чтобы вызывать метод BuildContent() базового класса:
public override void Process(TagHelperContext context, TagHelperOutput output)
{
BuildContent(output,nameof(CarsController.Index),
"text-default","Back to List","list");
}
Код создает ссылку Back to List (Список) с изображением значка списка из Font Awesome. Чтобы не возникали ошибки при компиляции, добавьте в CarsController базовый метод Index():
public IActionResult Index()
{
return View();
}
Обеспечение видимости специальных вспомогательных функций дескрипторов
Чтобы сделать специальные вспомогательные функции дескрипторов видимыми, потребуется выполнить команду @addTagHelper для представлений, которые используют эти вспомогательные функции дескрипторов, или поместить ее в файл _ViewImports.cshtml. Откройте файл _ViewImports.cshtml в каталоге Views и добавьте в него следующую строку:
@addTagHelper *, AutoLot.Mvc
Вспомогательные функции HTML
Вспомогательные функции HTML из ASP.NET MVC по-прежнему поддерживаются, а некоторые из них применяются довольно широко и перечислены в табл. 31.5.
Вспомогательная функция DisplayFor()
Вспомогательная функция DisplayFor() отображает объект, определяемый выражением. Если для отображаемого типа существует шаблон отображения, тогда он будет применяться при создании HTML-разметки, представляющей элемент. Например, если моделью представления является сущность Car, то информацию о производителе автомобиля можно отобразить следующим образом:
@Html.DisplayFor(x=>x.MakeNavigation);
Если в каталоге DisplayTemplates присутствует представление по имени Make.cshtml, тогда оно будет использоваться для визуализации значений (вспомните, что поиск имени шаблона базируется на типе объекта, а не на имени его свойства). Если представление по имени ShowMake.cshtml (например) существует, то оно будет применяться для визуализации объекта с помощью приведенного ниже вызова:
@Html.DisplayFor(x=>x.MakeNavigation, "ShowMake");
В случае если шаблон не указан и отсутствует представление с именем класса, тогда для создания HTML-разметки, подлежащей отображению, используется рефлексия.
Вспомогательная функция DisplayForModel()
Вспомогательная функция DisplayForModel() отображает модель для представления. Если для отображаемого типа существует шаблон отображения, то он будет применяться при создании HTML-разметки, представляющей элемент. Продолжая предыдущий пример представления с сущностью Car в качестве модели, полную информацию Car можно отобразить следующим образом:
@Html.DisplayForModel();
Как и в случае со вспомогательной функцией DisplayFor(), если существует шаблон отображения, имеющий имя типа, тогда он будет использоваться. Можно также применять именованные шаблоны. Скажем, для отображения сущности Car с помощью шаблона отображения CarWithColors.html необходимо использовать такой вызов:
@Html.DisplayForModel("CarWithColors");
Если шаблон не указан и отсутствует представление с именем класса, то для создания HTML-разметки, подлежащей отображению, используется рефлексия.
Вспомогательные функции EditorFor() и EditorForModel()
Вспомогательные функции EditorFor() и EditorForModel() работают аналогично соответствующим вспомогательным функциям для отображения, но с тем отличием, что шаблоны ищутся в каталоге EditorTemplates и вместо представления объекта, предназначенного только для чтения, отображаются HTML-формы редакторов.
Управление библиотеками клиентской стороны
До завершения представлений нужно обновить библиотеки клиентской стороны (CSS и JavaScript). Проект диспетчера библиотек LibraryManager (первоначально разрабатываемый Мэдсом Кристенсеном) теперь является частью Visual Studio (VS2019) и также доступен в виде глобального инструмента .NET Core. Для извлечения инструментов CSS и JavaScript из CDNJS.com, UNPKG.com, jsDelivr.com или файловой системы в LibraryManager используется простой файл JSON.
Установка диспетчера библиотек как глобального инструмента .NET Core
Диспетчер библиотек встроен в Visual Studio. Чтобы установить его как глобальный инструмент .NET Core, введите следующую команду:
dotnet tool install --global Microsoft.Web.LibraryManager.Cli --version 2.1.113
Текущая версия диспетчера библиотек доступна по ссылке https://www.nuget.org/packages/Microsoft.Web.LibraryManager.Cli/.
Добавление в проект AutoLot.Mvc библиотек клиентской стороны
При создании проекта AutoLot.Mvc (с помощью Visual Studio или командной строки .NET Core CLI) в каталог wwwrootlib было установлено несколько файлов JavaScript и CSS. Удалите каталог lib вместе со всеми содержащимися в нем файлами, т.к. все они будут заменены диспетчером библиотек.
Добавление файла libman.json
Файл libman.json управляет тем, что именно устанавливается, из каких источников и куда попадают установленные файлы.
Visual Studio
Если вы работаете в Visual Studio, тогда щелкните правой кнопкой мыши на имени проекта AutoLot.Mvc и выберите в контекстном меню пункт Manage Client-Side Libraries (Управлять библиотеками клиентской стороны), в результате чего в корневой каталог проекта добавится файл libman.json. В Visual Studio также есть возможность связать диспетчер библиотек с процессом MSBuild. Щелкните правой кнопкой мыши на имени файла libman.json и выберите в контекстном меню пункт Enable restore on build (Включить восстановление при сборке). Вам будет предложено разрешить другому пакету NuGet (Microsoft.Web.LibraryManager.Build) восстановиться в проекте. Разрешите установку пакета.
Командная строка
Создайте новый файл libman.json посредством следующей команды (она устанавливает CDNJS.com в качестве стандартного поставщика):
libman init --default-provider cdnjs
Обновление файла libman.json
Для поиска библиотек, подлежащих установке, сеть доставки содержимого CDNJS.com предлагает удобный для человека API-интерфейс. Список всех доступных библиотек можно просмотреть по следующему URL:
https://api.cdnjs.com/libraries?output=human
Найдя библиотеку, которую вы хотите установить, модифицируйте URL, указав имя библиотеки из списка, чтобы увидеть ее версии и файлы для каждой версии. Например, для просмотра всех доступных версий и файлов jQuery используйте такую ссылку:
https://api.cdnjs.com/libraries/jquery?output=human
После выбора версии и файлов для установки добавьте имя библиотеки (плюс версию), место назначения (обычно wwwroot/lib/<ИмяБиблиотеки>) и файлы, которые требуется загрузить. Скажем, чтобы загрузить jQuery, введите в массив JSON библиотеки следующий код:
{
"library": "[email protected]",
"destination": "wwwroot/lib/jquery",
"files": [ "jquery.js"]
}
Ниже приведено полное содержимое файла
