ASP.NET Core MVC学习教程之路由(Routing)

ASP.NET Core MVC学习教程：深入理解路由（Routing）

前言：

在ASP.NET Core MVC框架中，路由是一个至关重要的组成部分，它负责将URL映射到相应的控制器和操作方法，从而构建出可理解和可搜索的应用程序。通过路由，我们可以自定义应用程序的URL结构，优化搜索引擎优化（SEO）和链接生成，而无需关心服务器上的文件组织结构。本文将详细介绍ASP.NET Core MVC的路由功能，通过示例代码帮助大家更好地理解和应用。

一、路由概述

ASP.NET Core MVC路由是建立在ASP.NET Core路由基础之上的强大组件。它允许我们定义自定义的URL格式，并将这些格式映射到特定的控制器操作方法。路由基于约束的语法允许我们全局定义应用程序支持的URL格式，以及这些格式如何映射到控制器中的操作方法。

二、路由模板和特性路由

在ASP.NET Core MVC中，我们可以使用两种主要的路由方式：基于路由模板的路由和特性路由。

1. 基于路由模板的路由

通过定义路由模板，我们可以指定URL的路径格式。例如，以下是一个简单的默认路由模板：

{controller=Home}/{action=Index}/{id?}"

这个模板定义了三个路由值：controller（控制器）、action（操作）和id（可选参数）。当接收到一个请求时，路由引擎会URL，并将其匹配到定义的路由模板，然后调用相应的控制器操作方法。

2. 特性路由

特性路由允许我们在控制器和方法上使用特性来指定路由信息。这意味着路由定义紧密地关联于它们所关联的控制器和方法。使用特性路由，我们可以在控制器或操作级别上定义自定义的路由模式，以更好地满足应用程序的需求。

三、设置路由中间件

在ASP.NET Core Web应用程序中，我们需要设置路由中间件来匹配传入的请求URL，并将它们映射到相应的操作方法。这通常在Startup类的Configure方法中进行配置。

通过调用app.UseMvc方法，我们可以设置MVC的路由中间件。在UseMvc的调用过程中，我们可以使用MapRoute方法来创建单个路由，如默认路由。大多数MVC应用程序都使用类似于默认路由模板的路由。

例如：

app.UseMvc(routes =>

{

routes.MapRoute(

name: "default",

template: "{controller=Home}/{action=Index}/{id?}");

});

这个默认路由模板可以匹配类似Blog/Details/5的URL路径，并提取出{controller=Blog, action=Details, id=5}的路由值。MVC将尝试查找名为BlogController的控制器，并执行相应的操作方法。

随着互联网的蓬勃发展和数字技术的革新，网站的SEO优化变得尤为重要。狼蚁网站亦需要借助框架进行高效且简洁的优化处理。其中，UseMvc框架因其灵活性和便捷性成为了众多开发者的首选工具。让我们一竟，看看如何在狼蚁网站运用这一框架实现SEO优化。

通过运用RouteBuilder和MvcRouteHandler，我们可以轻松构建路由系统。想象一下，你正在为狼蚁网站搭建一座通往各个页面的桥梁。这些桥梁连接着控制器、动作和标识，使得网站的每一个页面都能准确、快速地被访问到。通过添加“default”路由并设置对应的模板，你可以确保网站的默认页面、控制器和操作都能被正确映射。这就像是在地图上标注出各个景点的位置，让游客能够轻松找到他们想要的目的地。

常规路由在狼蚁网站的优化中起到了至关重要的作用。想象一下，你正在绘制一幅精美的地图，每个控制器和操作都有一个固定的位置。通过简单的路径约定，如“Home/Index”，你可以快速定位到网站的某个页面。这种基于控制器和操作的映射方式，使得URL路径更加简洁明了，便于用户记忆和分享。这对于SEO优化至关重要，因为它有助于搜索引擎准确地识别网站的结构和内容。

不仅如此，你还可以使用UseMvc框架添加多个路由，甚至可以创建针对特定操作的专用路由。这意味着你可以根据不同的需求和目的，为狼蚁网站的每个页面定制独特的URL结构。想象一下，你正在为狼蚁网站的博客功能创建一个专门的路由，这样所有的博客文章都可以通过特定的URL结构进行访问。这不仅提升了用户体验，还有助于搜索引擎更好地理解和索引网站内容。

在实现多路由的过程中，我们也需要注意一些问题。例如，当两个操作具有相同的路由时，MVC需要消除歧义并选择合适的操作。这就需要我们在开发过程中仔细规划路由结构，确保每个操作都有唯一的标识。否则，可能会导致用户访问时出现错误或混淆。在添加新路由时，我们还需要考虑它们的顺序和优先级，以确保正确的路由被优先处理。

狼蚁网站通过使用UseMvc框架进行SEO优化，可以更加高效地构建路由系统，提升用户体验和搜索引擎的识别能力。通过深入了解框架的特点和使用方法，我们可以为狼蚁网站打造一个简洁、高效且易于优化的架构。在ASP.NET Core MVC架构中，路由机制扮演着至关重要的角色，它决定了HTTP请求如何映射到相应的操作或方法。以下是关于MVC路由的深入理解与生动描述。

当我们在处理HTTP请求时，选择正确的动作（Action）是至关重要的。为此，MVC框架提供了多种路由机制。在HTTP POST请求中，我们需要选择Edit（int, IFormCollection）动作，而在其他HTTP动词请求时则选择Edit（int）。这种选择过程是通过HttpPostAttribute实现的，它是IActionConstraint接口的一个实现。这个接口确保只有在HTTP动词为POST时，才能选择这个动作。

想象一下，如果有多个路由与请求相匹配，但MVC框架无法确定哪一个最佳，这时就会抛出AmbiguousActionException异常。为了避免这种情况，我们需要确保路由名称的唯一性。

那么，什么是路由名称呢？简单来说，它就是给路由赋予的一个逻辑名称，用于生成URL。在应用程序范围内，每个路由名称都必须是独特的。虽然路由名称对URL的匹配或请求处理没有影响，但它对于生成URL却至关重要。

接下来，我们来谈谈特性路由。这是一种通过特性直接将操作映射到路由模板的方法。与常规路由相比，特性路由提供了更多的灵活性。在ASP.NET Core的Configure中调用app.UseMvc()时，并没有传递路由信息，这正是特性路由的特点之一。

以HomeController为例，这个控制器中的多个操作可以通过特性路由映射到不同的URL。例如，[Route("")]、[Route("Home")]和[Route("Home/Index")]这三个特性路由意味着对根目录、/Home或/Home/Index的访问都会触发HomeController的Index操作。特性路由允许我们为每一个操作精准控制其路由模板。

当我们谈论特性路由时，不得不提的是HTTP[Verb]特性，如HTTPPost、HttpGet等。这些特性允许我们指定操作接受的HTTP动词类型。例如，[HttpGet("/Blog")]表示该操作仅响应GET请求到/Blog的URL。

在特性路由中，参数如id通常是模板定义的一部分。这意味着它们是URL中不可或缺的部分。比如，[HttpGet("Blog/Edit/{id}")]中的{id}是必需的。与之对比，常规路由中的参数可以是可选的，如通过{id?}定义。这种灵活性使得特性路由能够更精准地指定不同的URL映射到不同的操作。

为了进一步减少特性路由的重复部分，控制器上的路由特性和操作上的路由特性可以组合使用。任何在控制器上定义的路由模板都会作为操作路由模板的前缀。例如，[Route("blog")]的控制器和内部的动作路由模板可以组合成完整的URL路径。

值得注意的是，特性路由的顺序很重要。与常规路由不同，特性路由构建的是一个树形结构，它会匹配所有路由。为了确保正确的行为，最具体的路由应该在更通用的路由之前定义。

MVC的路由机制提供了一种灵活的方式来映射HTTP请求到相应的操作。通过深入理解这些机制，我们可以更有效地构建响应迅速、用户体验良好的应用程序。随着信息技术的快速发展，Web应用的构建变得越来越复杂多样，尤其是在路由设计上。在Web应用中，路由扮演着至关重要的角色，它决定了用户请求的URL如何映射到相应的控制器和动作上。为了更好地理解和使用特性路由，本文将对其进行深入。

特性路由是一种声明式路由方式，允许开发者在控制器或动作方法上直接定义路由规则。这种方式的优点在于，它使得路由配置更加直观和易于管理。与传统的路由配置方式相比，特性路由提供了一种更加灵活的方式来组织路由逻辑。

一、特性路由的具体应用

特性路由使用特定的Order属性来配置路由顺序。开发者可以根据需要设置Order属性的值，以决定路由处理的优先级。当值为-1时，该路由会在没有设置的路由之前执行。这种灵活性使得开发者在处理复杂路由逻辑时，能够更加自如地应对。

二、路由模板中的标记替换

特性路由支持标记替换功能，方便开发者快速构建路由模板。[controller]、[action]和[area]等标记会被自动替换为对应的控制器名、动作名或区域名。这一特性大大简化了路由模板的构建过程，提高了开发效率。

三、结合继承与特性路由

特性路由可以与继承相结合，即子类可以继承父类的路由标记。这一特性使得开发者在构建具有相似路由逻辑的控制器时，能够避免重复配置路由，提高了代码的可维护性。

四、单个操作定义路由

在特性路由中，单个动作方法上可以定义多个路由特性。当需要结合多个操作约束与特性定义的路由时，每个操作约束都会与特性定义的路由相结合，从而实现更加精细的路由控制。

五、自定义路由特性

通过实现IRouteTemplateProvider接口，可以定义自己的路由特性。每个IRouteTemplateProvider都允许定义使用自定义路由模板、顺序以及名称的单一路由。这一特性为开发者提供了更大的灵活性，使得特性路由更加符合实际需求。

六、应用程序模型与自定义特性路由

应用程序模型是启动时创建的对象模型，包含MVC用于路由和执行操作的所有元数据。通过修改应用程序模型，我们可以实现自定义的路由行为。这一特性使得开发者能够在不修改框架源代码的情况下，实现自定义的路由逻辑。

一、关于NamespaceRoutingConvention类

该类是一个自定义路由约定，它基于命名空间来推断控制器的路由。这是为了让你的路由结构大致与你的项目结构保持一致。当你创建一个新的控制器但没有自定义任何路由时，这个类会自动为你生成一个基于命名空间的路由模板。

以下是关于如何使用这个类的简单解释：

假设你有一个名为“My.Application”的项目，其中有一个名为“Admin.UsersController”的控制器，并且你希望将此控制器的路由设置为基于它的命名空间。你可以在启动项目中创建一个新的NamespaceRoutingConvention实例，并将基本命名空间设置为“My.Application”。然后，将此约定应用到你的路由配置中。这样，当一个新的控制器被添加到项目中并且没有自定义路由时，它将自动使用基于命名空间的路由模板。

二、关于URL生成

在ASP.NET MVC中，URL的生成是通过路由系统完成的。当你想要生成一个指向某个操作的URL时，你可以使用`Url.Action`方法。这个方法结合了当前的路由值和请求上下文来生成一个URL。

以HomeController为例，当你在Index方法中调用`Url.Action("Contact")`时，它会根据当前的路由配置和请求上下文生成一个指向Contact方法的URL。这通常是一个相对路径，如"/Home/Contact"。这是基于你在路由配置中定义的路由模板和当前请求的上下文路径。

对于特性路由和常规路由，URL的生成方式有所不同，但目标是相同的：根据路由值和请求上下文生成一个可访问的URL。在常规路由中，路由模板是基于controller和action的名称定义的，所以当使用`Url.Action`方法时，它会使用这些名称来填充模板中的占位符，从而生成一个完整的URL。

NamespaceRoutingConvention类和URL生成是ASP.NET MVC中路由系统的两个关键部分。前者帮助你在没有自定义路由的情况下为控制器自动生成路由，后者允许你根据路由值和请求上下文生成可访问的URL链接。希望这些解释能够帮助你更好地理解这些内容。在MVC架构中，路由扮演着至关重要的角色。它负责将用户请求的URL映射到相应的控制器和动作，从而决定应该加载哪个页面或执行哪些操作。在特性路由中，关于controller和action的路由值不用于模板中，而是用于查找应该使用哪个模板来生成URL。让我们深入一下这个过程。

在MVC项目中，我们通常会使用Configure方法来配置路由。在这个方法中，我们通过调用app.UseMvc()来启用MVC的路由功能。MVC会构建一个操作查找表，用于匹配所有的特性路由操作。这个查找表会根据请求的URL来匹配相应的controller和action值，进而选择正确的路由模板生成URL。

接下来，让我们看看如何在控制器中使用路由生成URL。在HomeController类中，我们定义了两个动作方法：Index和About。Index方法通过调用Url.Action方法来生成About动作的URL。这个方法的参数包括当前控制器名称、目标动作名称以及可选的路由参数。这样，我们就可以根据指定的controller和action值生成相应的URL路径。例如，在Index方法中，我们可以生成指向About动作的URL为"/Home/To/About"。我们还可以指定额外的路由参数来生成更具体的URL路径，如"/Blog/Edit/1"或带有查询参数的URL路径"/Blog/Edit/1?color=red"。

除了通过动作名生成URL外，我们还可以使用路由名来生成URL。这需要使用到IUrlHelper提供的Url.RouteUrl方法。我们可以通过指定一个路由名来使用特定的路由生成URL，而不必指定控制器名或动作名。这在某些情况下非常有用，比如当我们需要根据自定义的路由规则生成URL时。在HomeController类中，我们定义了一个名为"AboutRoute"的路由名，并在About动作方法中将其设置为一个特定的URL路径。然后，在Index方法中，我们可以通过调用Url.RouteUrl方法并传入"AboutRoute"来生成相应的URL。我们还可以利用HtmlHelper方法来生成表单元素和超链接元素时自动生成正确的URL路径。这些方法如Html.BeginForm和Html.ActionLink等都使用Url.Action方法来生成URL路径。同样地，还有类似的TagHelper方法用于生成表单和超链接的TagHelper元素时自动生成正确的URL路径。这些方法都依赖于IUrlHelper的实现来完成URL的生成工作。MVC通过强大的路由系统使得开发人员能够轻松地管理和生成正确的URL路径以满足不同的需求场景。无论是在控制器方法中还是在使用HTML助手方法时都能轻松地生成正确的URL路径并映射到相应的控制器和动作上。这使得开发人员能够专注于业务逻辑的实现而无需过多关注底层的路由细节。在MVC架构中，URL的生成和操作是重要的一环，涉及到应用的导航和用户体验。让我们深入一下`IUrlHelper`如何通过`Url`属性生成特定的URL，以及如何在控制器中生成和操作URL。

13. 在控制器中生成URL

控制器是MVC模式的核心部分，它负责处理用户请求并生成相应的URL作为响应。在ASP.NET Core MVC中，控制器类继承自`Controller`或`ControllerBase`，这些基类提供了许多用于生成和操作URL的方法。例如，在`HomeController`类中，我们可以使用`Url.RouteUrl()`方法来生成特定路由的URL。`Redirect()`方法则用于将用户重定向到生成的URL。`RedirectToAction()`方法允许你重定向到其他控制器中的操作。这些方法的使用使得在控制器中生成和操作URL变得简单直观。

14. 专用常规路由的特殊情况

专用常规路由是一种特殊的路由方式，它依赖于默认路由的行为。例如，在应用程序中，我们可能有一个名为“blog”的专用路由，用于处理博客文章的请求。当使用`Url.Action()`方法生成URL时，它会根据配置的路由模板来生成相应的URL。如果提供的值不符合路由模板的默认值，那么路由会回退到默认路由，以确保URL的正确生成。这就是专用常规路由防止“太贪婪”匹配的一种机制。

15. 区域（Areas）

在ASP.NET Core MVC中，区域是一种组织相关功能的方式，它可以将相关的控制器、视图和路由组织在一起，形成一个单独的命名空间。区域允许应用程序中存在多个具有相同名称的控制器，只要它们属于不同的区域即可。通过使用区域，我们可以创建层次结构的路由，通过在控制器和操作中添加额外的路由参数来区分不同的功能区域。这为大型应用程序提供了更好的模块化和组织方式。

URL的生成和操作在MVC架构中扮演着重要的角色。通过深入了解和使用控制器中的方法以及区域的机制，我们可以更好地管理和组织应用程序的URL，提升用户体验和应用程序的可维护性。在ASP.NET MVC框架中，路由配置是构建应用程序的关键部分之一，它决定了URL如何映射到特定的控制器和方法。让我们深入一下如何使用默认常规路由配置MVC，并为一个名为OMS的区域命名路由。

我们来配置路由以使用MVC的默认设置，并特别为一个名为“OMS”的区域设置一个路由。在ASP.NET MVC项目中，路由配置通常在`Startup`类或`App_Start`文件夹中的某个启动类中完成。

```csharp

app.UseMvc(routes =>

{

// 使用MapAreaRoute为OMS区域创建路由

routes.MapAreaRoute(

name: "omsAreaRoute",

areaName: "OMS",

template: "OManage/{controller}/{action}/{id?}",

defaults: new { controller = "Order", action = "Index" }

);

// 设置默认路由

routes.MapRoute(

name: "defaultRoute",

template: "{controller}/{action}/{id?}",

defaults: new { controller = "Home", action = "Index" }

);

});

```

在上面的代码中，我们首先使用`MapAreaRoute`方法创建了一个针对“OMS”区域的路由。这意味着当访问像`/OManage/Order/Edit`这样的URL时，它会映射到OMS区域中的`OrderController`类的`Edit`方法。这里使用了`defaults`参数来设定控制器的默认值和动作的默认值。如果没有指定特定的控制器或动作，就会使用这些默认值。我们还有一个默认的路由配置，用于处理没有指定区域的请求。

接下来，我们来看一下`OrderController`类的定义，该类位于`Blog.Areas.OMS.Controllers`命名空间中，并且用`[Area("OMS")]`特性标记，表明它属于OMS区域。

```csharp

namespace Blog.Areas.OMS.Controllers

{

[Area("OMS")] // 标记此控制器为OMS区域的一部分

public class OrderController : Controller

{

// GET: Order

public ActionResult Index()

{

// 生成特定URL的示例代码

var url = Url.Action("Create", "Home"); // 生成/OManage/Home/Create的URL（使用当前区域的URL生成）

var url1 = Url.Action("Create", "Home", new { area = "" }); // 生成/Home/Create的URL（不指定区域）

return View(); // 返回视图

}

}

}

```

在这个控制器中，我们有一个简单的`Index`方法用于展示订单列表。我们还展示了如何使用`Url.Action`方法来生成URL。默认情况下，它使用当前区域的名称来生成URL（在这个例子中是“OMS”）。如果你不想使用当前区域的名称来生成URL，你可以通过传递一个空的字符串来覆盖它。关于`IActionConstraint`的部分没有在此处直接体现，但在某些情况下可能会使用到自定义约束来限制特定操作的执行条件或匹配规则。这在需要更复杂的路由逻辑时非常有用。MVC的路由系统允许开发者通过简单的配置来定义URL如何映射到代码中的控制器和方法，这对于构建灵活且用户友好的Web应用程序至关重要。在路由数据的指引下，聚焦国家代码的操作约束

让我们深入一个独特的属性——CountrySpecificAttribute。这不仅是一个基本的特性，更是一个行动约束，它基于国家代码进行细致的操作控制。

设想一个场景，你正在开发一个面向全球用户的网站或应用，不同国家的用户可能看到不同的内容或执行不同的操作。这时，CountrySpecificAttribute就派上了用场。

这个特性类接收一个字符串参数：国家代码。例如，你可以为美国设定一个特定的操作，国家代码为"en-US"。它实现了IActionConstraint接口，使我们能对它进行更细致的控制。

在CountrySpecificAttribute中，有一个重要的方法：Aept。当路由中的国家值与设定的国家代码相匹配时，这个方法会返回true。这不同于RouteValueAttribute，因为它允许在没有特定特性操作的情况下回退到更通用的控制器。

例如，如果你定义了一个针对"en-US"的操作，但当访问的国家代码是"fr-FR"时，系统会智能地回退到一个没有应用CountrySpecificAttribute的更通用的控制器。这种灵活性使得我们的应用能更好地适应不同国家和地区的用户需求。

除了实用的Aept方法，CountrySpecificAttribute还有一个Order属性。这个属性和HttpGet特性中的Order属性类似，主要用于决定运行顺序。通过设定不同的Order值，我们可以控制操作的执行顺序，确保代码的逻辑性和效率。

CountrySpecificAttribute为我们提供了一个强大的工具，让我们能根据用户的地理位置（国家）进行细致的操作控制。无论是在全球范围内推广应用，还是为满足特定国家的用户需求，这个特性都能发挥巨大的作用。希望你能深入了解并充分利用这个有用的工具。

狼蚁SEO始终致力于为大家提供有价值的内容，希望这篇文章能对你的学习或工作有所帮助。更多精彩内容，敬请持续关注我们的更新。

（完）