ASP.NET Core MVC路由(Routing)的用法_基础应用_

 ASP.NET Core MVC 路由是建立在ASP.NET Core 路由的，一项强大的URL映射组件，它可以构建具有理解和搜索网址的应用程序。这使得我们可以自定义应用程序的URL命名形式，使得它在搜索引擎优化（SEO）和链接生成中运行良好，而不用关心Web服务器上的文件是怎么组织的。我们可以方便的使用路由模板语法定义路由，路由模板语法支持路由值约束，默认值和可选值。

基于约束的路由允许全局定义应用支持的URL格式，以及这些格式是怎样各自在给定的控制器中映射到指定的操作方法(Action)。当接受到一个请求时，路由引擎解析URL并将其匹配至一个定义URL格式，然后调用相关的控制器操作方法。

routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}");

特性路由(Attribute Routing) 允许以在控制器和方法使用添加特性的方式指定路由信息来定义应用程序的路由。这意味着路由定义紧邻它们所关联的控制器和方法。

ASP.NET Core MVC 使用路由中间件来匹配传入请求的URL，并将它们映射到操作方法。路由在启动代码或属性中定义，它描述了网址路径应如何与操作方法匹配，还用于响应中生成链接并发送。

1.设置路由中间件

创建一个ASP.NET Core Web应用程序，在Startup类的Configure方法中有：

app.UseMvc(routes => { routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); });

在对UseMvc的调用过程中，MapRoute用于创建单个路由，即默认路由。大多数MVC应用程序都使用与默认路由模板类似的路由。

路由模板{controller=Home}/{action=Index}/{id?} 可以匹配类似 Blog/Details/5 的URL路径，并且提取路由值 {controller=Blog，action=Details，id=5}。MVC将尝试查找名为BlogController的控制器，并运行操作方法。

{controller=Home}将Home定义为默认控制器

{action=Index}将Index定义为默认操作

{id?}将id定义为可选

默认路径参数和可选路径参数可以不出现在需要匹配的URL路径中。

使用{controller=Home}/{action=Index}/{id?}模板，可以对以下URL路径都执行HomeController.Index：

/Home/Index/7

/Home/Index

/Home

/

有个简单方法 app.UseMvcWithDefaultRoute() 可以替换掉上面的方法。

UseMvc 和 UseMvcWithDefaultRoute 都是将RouteMiddleware的实例添加到中间件管道。MVC不直接与中间件交互，而是使用路由来处理请求。MVC通过MvcRouteHandler的实例链接到路由。下面的代码与UseMvc类似：

var route = new RouteBuilder(app); //添加连接到MVC，通过调用MapRoute来回调 route.DefaultHandler = new MvcRouteHandler(...); //执行回调以注册路由 route.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); //创建路由集合并添加至中间件 app.UseRouter(route.Build());

UseMvc 不直接定义任何路由，它为属性路由的路由集合添加一个占位符。重载UseMvc 使得我们可以添加自己的路由，并且还支持属性路由。UseMvc 及其所有变体为属性路由添加了占位符，这使得属性路由始终可用。UseMvcWithDefaultRoute定义默认路由并且支持属性路由。

2.常规路由

routes.MapRoute(name: "default",template: "{controller=Home}/{action=Index}/{id?}");  这是一个常规路由，因为它建立了一个约定的URL路径：

• 第一路径段映射到控制器名称
• 第二路径映射到操作名称
• 第三区段是可选id，用于映射到模型实体

使用default路由，URL 路径 /Blog/Index 将映射到BlogController.Index 操作。该映射是基于控制器和操作名称，而不是基于命名空间，源文件位置等。

使用常规路由的默认路由可以快速构建应用程序，而无需定义每一个操作的路由。对于CRUD 操作风格的应用程序，整个控制器的URL具有一致性。

3.多路由

可以在UseMvc 里面通过添加MapRoute 来添加多个路由。这样可以定义多个约定，或添加专用于特定操作的常规路由：

app.UseMvc(routes => { routes.MapRoute("blog", "blog/{*article}", defaults: new { Controller = "Blog", Action = "Index" }); routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); });

这里的blog 路由是专用常规路由，这意味着它不采用常规路由系统，而是专用于一个特定地的动作。这个路由始终映射到BlogController.Index。

路由集合中的路由是有序的，并且会按照它们被添加的顺序进行处理。

1.回退

作为请求处理的一部分，MVC将验证路由值是否可以用来查找应用程序中的控制器和操作。如果路由值不匹配操作，那么该路由被认为是不匹配的，将尝试下一个路由。这一过程称为回退，因为常规路由有重叠的情况。

2.行动歧义

当两个一致的操作通过路由时，MVC必须消除歧义，选择最佳操作，否则会抛出异常。例如：

public class BlogController : Controller { public ActionResult Edit(int id) { return View(); } [HttpPost] public ActionResult Edit(int id, IFormCollection collection) { try { // TODO: Add update logic here return RedirectToAction(nameof(Index)); } catch { return View(); } } }

URL /Blog/Edit/7 可以匹配这两个操作，这是MVC控制器的典型模式，其中Edit（int）用于显示编辑的表单，Edit（int,IFormCollection)用于 处理已提交的表单。为了达到这个目的，MVC需要在HTTP POST时选择Edit（int,IFormCollection)，在其他HTTP动词时选择Edit（int）。

HttpPostAttribute 是IActionConstraint 的一个实现，它只允许在HTTP动词为POST时选择动作。IActionConstraint的存在使得Edit（int,IFormCollection)比Edit（int）更好匹配。

如果有多个路由匹配，并且MVC无法找到一个最佳路由，则会抛出AmbiguousActionException异常。

3.路由名称

上面的例子中"blog"和"default"字符串是路由名称，路由名称为路由提供了一个逻辑名称，以便命名的路由可用于生成URL。在应用程序范围内路由必须名称必须是唯一的。

路由名称对URL匹配或请求的处理没有影响，仅用于URL生成。

4.路由特性

特性路由使用一组特性直接将操作映射到路由模板。下面在Configure中调用 app.UseMvc(); 没有传递路由。

public class HomeController : Controller { [Route("")] [Route("Home")] [Route("Home/Index")] public IActionResult Index() { return View(); } [Route("Home/About")] public IActionResult About() { ViewData["Message"] = "Your application description page."; return View(); } }

HomeController.Index操作将会对 /，/Home 或者/Home/Index 任一URL访问执行。

特性路由需要有更多的输入来指定一个路由，而常规路由处理路由时更加简洁。然而，特性路由允许精准控制每个操作的路由模板。

上面的模板中没有定义针对 action,area ,controller的路由参数。实际上，这些参数不允许出现在特性路由中，因为路由模板已经关联了一个操作，解析URL中的操作名是没有意义的。

特性路由也可以使用HTTP[Verb]特性，如HTTPPost：

[HttpGet("/Blog")] public ActionResult Index() { return View(); }

由于特性路由适用于特定操作，因此很容易使参数作为模板定义中必须的一部分。下面的例子，id是URL中必须的一部分：

[HttpGet("Blog/Edit/{id}")] public ActionResult Edit(int id) { return View(); }

常规的默认路由定义id参数作为可选项({id?}),而特性路由的是必须参数，这种可以精准指定，比如包/Blog/Get 和 /Blog/Get/{id} 分配到不同的操作。

5.组合路由

为了减少特性路由的重复部分，控制器上的路由特性会和各个操作上的路由特性进行结合。任何定义在控制器上的路由模板都会作为操作路由模板的前缀。

[Route("blog")] public class BlogController : Controller { [HttpGet] public ActionResult GetAll() { return View(); } [HttpGet("{id}")] public ActionResult GetById(int id) { return View(); } }

/blog 匹配GetAll方法， /blog/1 匹配 GetById方法。

注意，如果操作上路由模板以 / 开头时不会结合控制器上的路由模板。

6.特性路由的顺序

常规路由会根据定义顺序来执行，与之相比，特性路由会构建一个树形结构，同时匹配所有路由。这种看起来像路由条目被放置在一个理想的顺序中，最具体的路由会在一般的路由之前执行。比如，路由blog/Edit/4 比 blog/{*article} 更加具体。

特性路由使用所有框架提供的路由特有的Order属性来配置顺序，并根据Order属性升序处理路由。默认是0，设置为-1时会在没有设置的路由之前执行。

7.路由模板中的标记替换( [controller] , [action] , [area])

为了方便，特性路由支持标记替换，即通过在在方括号中封闭一个标记（[, ]）来替换对应的名称。标记[action],[area],[controller]会被替换成操作所对应的操作名，区域名，控制器名。

[Route("[controller]/[action]")] public class BlogController : Controller { [HttpGet]//匹配Blog/GetAll public ActionResult GetAll() { return View(); } }

标记替换发生在构建特性路由的最后一步。与上面结果相同的写法：

public class BlogController : Controller { [HttpGet("[controller]/[action]")]//匹配Blog/GetAll public ActionResult GetAll() { return View(); } }

特性路由也可以与继承相结合，即继承父类的路由标记。

特性路由支持单个操作定义路由。如果用IActionConstarint实现的多个路由特性定义在一个操作上时，每个操作约束与特性定义的路由相结合：

[Route("Store")] [Route("[controller]")] public class BlogController : Controller { [HttpGet("GetAll")]//匹配 Get Blog/GetAll和 Store/GetAll [HttpPost("Set")]//匹配 Post Blog/Set和 Store/Set public ActionResult GetAll() { return View(); } }

虽然使用多个路由到一个操作看起来很强大，但最好还是保持URL的空间简单和定义明确。使用多个路由到操作上仅仅在特殊需要的时候，比如支持多个客户端。

8.使用IRouteTemplateProvider自定义路由特性

所有框架提供的路由特性（[Route(...) ] ，[HttpGet(...)]等）都实现了 IRouteTemplateProvider 接口。当程序启动时，MVC查找控制器类和操作方法上都实现 IRouteTemplateProvider 接口的特性来构建储时路由集合。

可以通过实现 IRouteTemplateProvider 来定义自己的路由特性。每个 IRouteTemplateProvider 都允许定义使用自定义路由模板，顺序以及名称的单一路由：

public class MyApiControllerAttribute:Attribute, IRouteTemplateProvider { public string Template => "api/[controller]"; public int? Order { get; set; } public string Name { get; set; } }

当 [MyApiController] 特性被应用时，会自动设置Template 为 api/[controller] 。

9.使用应用程序模型来自定义特性路由

应用程序模型时启动时创建的对象模型，其中包含MVC用于路由和执行操作的所有元数据。应用程序模型包括从路由特性收集的所有数据（通过 IRouteTemplateProvider）。我们可以编写约定以在启动时修改应用程序模型为自定义路由行为。

public class NamespaceRoutingConvention:IControllerModelConvention { private readonly string _baseNamespace; public NamespaceRoutingConvention(string baseNamespace) { _baseNamespace = baseNamespace; } public void Apply(ControllerModel controller) { var hasRouteAttributes = controller.Selectors.Any(selector => selector.AttributeRouteModel != null); if (hasRouteAttributes)
                
提示：
                    本文由神整理自网络，如有侵权请联系本站删除！
                    

                    本站声明： 

                    1、本站所有资源均来源于互联网，不保证100%完整、不提供任何技术支持； 

                    2、本站所发布的文章以及附件仅限用于学习和研究目的;不得将用于商业或者非法用途；否则由此产生的法律后果，本站概不负责！
                
                

                

                                            
上一篇：EF Core基础入门教程_实用技巧_
                                                                
下一篇：ASP.NET Core MVC中的模型（Model）_基础应用_