Язык программирования C#9 и платформа .NET5

public class HomeController : Controller

{

  [Route("/")]

  [Route("/Home")]

  [Route("/Home/Index")]

  [Route("/Home/Index/{id?}")]

  public IActionResult Index(int? id)

  {

    ...

  }

}

Основное различие между маршрутизацией на основе соглашений и маршрутизацией с помощью атрибутов заключается в том, что первая охватывает приложение, тогда как вторая — контроллер с атрибутом Route. Если маршрутизация на основе соглашений не применяется, то каждому контроллеру понадобится определить свой маршрут, иначе доступ к нему будет невозможен. Скажем, если в таблице маршрутов не определен стандартный маршрут, тогда следующий код обнаружить не удастся, т.к. маршрутизация для контроллера не сконфигурирована:

public class CarController : Controller

{

  public IActionResult Delete(int id)

  {

    ...

  }

}

На заметку! Маршрутизацию на основе соглашений и маршрутизацию с помощью атрибутов можно использовать вместе. Если бы в методе UseEndpoints() был настроен стандартный маршрут контроллера (как в примере с маршрутизацией на основе соглашений), то предыдущий контроллер попал бы в таблицу маршрутов.

Когда маршруты добавляются на уровне контроллера, методы действий получают этот базовый маршрут. Например, следующий маршрут контроллера охватывает Delete() и любые другие методы действий:

[Route("[controller]/[action]/{id?}")]

public class CarController : Controller

{

  public IActionResult Delete(int id)

  {

    ...

  }

}

На заметку! При маршрутизации с помощью атрибутов встроенные маркеры помечаются квадратными скобками ([]), а не фигурными ({}), как при маршрутизации на основе соглашений. Для специальных маркеров применяются все те же фигурные скобки.

Если методу действия необходимо перезапустить шаблон маршрута, тогда нужно предварить маршрут символом прямой косой черты (/). Скажем, если метод Delete() должен следовать шаблону URL вида mysite.eom/Delete/Car/5, то вот как понадобится сконфигурировать действие:

[Route("[controller]/[action]/{id?}")]

public class CarController : Controller

{

  [Route("/[action]/[controller]/{id}")]

   public IActionResult Delete(int id)

  {

    ...

  }

}

В маршрутах также можно жестко кодировать значения маршрутов вместо замены маркеров. Показанный ниже код даст тот же самый результат, как и предыдущий:

[Route("[controller]/[action]/{id?}")]

public class CarController : Controller

{

  [Route("/Delete/Car/{id}")]

  public IActionResult Delete(int id)

  {

    ...

  }

}

Именованные маршруты

Маршрутам можно также назначать имена, что обеспечит сокращение для перенаправления по определенному маршруту с указанием только его имени. Например, следующий атрибут маршрута имеет имя GetOrderDetails:

[HttpGet("{orderId}", Name = "GetOrderDetails")]

Маршрутизация и методы HTTP

Вы могли заметить, что ни в одном определении шаблона маршрута для методов не присутствует какой-нибудь метод HTTP. Причина в том, что механизм маршрутизации (в приложениях MVC и API) для выбора надлежащей конечной точки приложения использует шаблон маршрута и метод HTTP совместно.

Методы HTTP при маршрутизации в веб-приложениях (MVC)

Довольно часто при построении веб-приложений с применением паттерна MVC соответствовать определенному шаблону маршрута будут две конечные точки приложения. Средством различения в таких ситуациях является метод HTTP. Скажем, если CarController содержит два метода действий с именем Delete() и они оба соответствуют шаблону маршрута, то выбор метода для выполнения основывается на методе HTTP, который используется в запросе. Первый метод Delete() декорируется атрибутом HttpGet и будет выполняться, когда входящим запросом является GET. Второй метод Delete() декорируется атрибутом HttpPost и будет выполняться, когда входящим запросом является POST:

[Route("[controller]/[action]/{id?}")]

public class CarController : Controller

{

  [HttpGet]

  public IActionResult Delete(int id)

  {

    ...

  }

  [HttpPost]

  public IActionResult Delete(int id, Car recordToDelete)

  {

    ...

  }

}