IRouteValueProvider Интерфейс

Определение

Пространство имен:
Microsoft.AspNetCore.Mvc.Routing
Сборка:
Microsoft.AspNetCore.Mvc.Core.dll
Пакет:
Microsoft.AspNetCore.Mvc.Core v1.0.0
Пакет:
Microsoft.AspNetCore.Mvc.Core v1.1.0
Пакет:
Microsoft.AspNetCore.App.Ref v10.0.0-preview.6.25358.103
Пакет:
Microsoft.AspNetCore.Mvc.Core v2.0.0
Пакет:
Microsoft.AspNetCore.Mvc.Core v2.1.0
Пакет:
Microsoft.AspNetCore.Mvc.Core v2.2.0
Пакет:
Microsoft.AspNetCore.App.Ref v3.0.1
Пакет:
Microsoft.AspNetCore.App.Ref v3.1.10
Пакет:
Microsoft.AspNetCore.App.Ref v5.0.0
Пакет:
Microsoft.AspNetCore.App.Ref v6.0.6
Пакет:
Microsoft.AspNetCore.App.Ref v7.0.5
Пакет:
Microsoft.AspNetCore.App.Ref v8.0.0
Пакет:
Microsoft.AspNetCore.App.Ref v9.0.2
Исходный код:
IRouteValueProvider.cs

Интерфейс метаданных, указывающий значение маршрута, необходимое для выбора действия с помощью селектора действия. При применении к действию с помощью маршрутизации атрибутов значение маршрута будет добавлено в Values при выборе действия.

IRouteValueProvider Если используется для предоставления нового значения маршрута для действия, все действия в приложении также должны иметь значение, связанное с этим ключом, или иметь неявное значение null. Дополнительные сведения см. в примечаниях. 

public interface class IRouteValueProvider
public interface IRouteValueProvider
type IRouteValueProvider = interface
Public Interface IRouteValueProvider
Производный

Комментарии

Типичная схема выбора действия в приложении MVC заключается в том, что для действия требуются соответствующие значения для и ControllerName . ActionName

Для действия, например MyApp.Controllers.HomeController.Index(), для выбора Values должен содержать значения { "action": "Index", "controller": "Home" }

Если области используются в приложении (см AreaAttribute . раздел , который реализует IRouteValueProvider), то все действия рассматриваются либо в области с помощью значения, неnull являющегося областью (указанной AreaAttribute или другой IRouteValueProvider), либо считаются "за пределами" областей с помощью значения null.

Рассмотрим приложение с двумя контроллерами, каждый из которых имеет Index метод действия: , MyApp.Controllers.HomeController.Index()MyApp.Areas.Blog.Controllers.HomeController.Index() - где MyApp.Areas.Blog.Controllers.HomeController имеет атрибут [Area("Blog")]области .

Например Values : { "action": "Index", "controller": "Home" }

MyApp.Controllers.HomeController.Index() будет выбран. MyApp.Area.Blog.Controllers.HomeController.Index() не считается допустимым, Values так как не содержит значение "Blog" для "area".

Для Values like: { "area": "Blog", "action": "Index", "controller": "Home" }

MyApp.Area.Blog.Controllers.HomeController.Index() будет выбран. MyApp.Controllers.HomeController.Index() не считается допустимым, так как значения маршрута содержат значение для "area". MyApp.Controllers.HomeController.Index() не может соответствовать ни одному значению для "area", отличному от null.

Свойства

RouteKey

Ключ значения маршрута.
RouteValue

Значение маршрута. Если null значение или пустое, необходимо, чтобы значение маршрута, связанное с RouteKey , было пропущено или null.

Применяется к