ASP.NET Core 5 是一个开源的用于构建现代化web程序的开发框架,由于 ASP.NET Core 5 是基于 .NET Core 运行时,有了它,你可以将 web程序 运行在 Windows,Linux 和 Mac 上,值得注意的是, ASP.NET Core 5 整合了 Web API 和 MVC。

接下来回到本篇主题,何为方法重载? 就是让多个不同签名的方法共享一个方法名的技术,这种技术在 C# 中被广泛使用,但用在 ASP.NET 5 中就不是那么直观了,这篇文章我们就来讨论如何重载 Action。

action 是什么

Action 就是 Controller 下标记为 public 并且 没有被 [NonAction]特性标记的方法,如下代码:

public class HomeController : Controller { public IActionResult Index() { return View(); } }

虽然看起来和普通方法一样,但是这些方法必须遵守下面这些约束。

当你创建好 MVC 项目,默认的 Index Action 也会自动创建,在 Startup.Configure 下的路由配置中也默认配置了此Action,如下代码所示:

public class Startup { public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseEndpoints(endpoints => { endpoints.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); }); } }

如果你不想使用默认的 Index,可以修改成其他你认为适合的,比如 Values

public class Startup { public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseEndpoints(endpoints => { endpoints.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Values}/{id?}"); }); } }

使用相同的 谓语动词 重载 action 方法

首先瞄一下 HomeController 类是啥样子。

public class HomeController : Controller { private readonly ILogger<HomeController> _logger; public HomeController(ILogger<HomeController> logger) { _logger = logger; } public IActionResult Index() { return View(); } public IActionResult Index(string text) { return View(); } public IActionResult Privacy() { return View(); } [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)] public IActionResult Error() { return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier }); } }

注意上面类中我新增了一个 public IActionResult Index(string text) 方法,编译器没有给出任何错误提示,然而把应用程序跑起来,你会遇到一个运行时错误,如下图所示:

asp.net引用模块(如何在ASP.NET中重载)(1)

使用不同的 谓语动词 重载 action

现在修改一下 重载方法Index, 在新加入的重载方法上标上 HttpPost 特性,代码如下所示:

[HttpPost] public IActionResult Index(string text) { return View(); }

当再次运行应用程序,这次就没有任何编译时或者运行时错误了,如下图所示:

asp.net引用模块(如何在ASP.NET中重载)(2)

使用 ActionName 特性 重载 action

可以通过 ActionName 特性实现 Action 方法的重载,值得注意的是,ActionName 特性中标记的名字不能相同,如下代码所示:

[ActionName("Index")] public IActionResult Index() { return View(); } [ActionName("Index With Parameter")] public IActionResult Index(string text) { return View(); }

再次运行程序,一切都是ok的,没有任何编译时或者运行时错误,截图如下:

asp.net引用模块(如何在ASP.NET中重载)(3)

使用 Route 特性 重载 action

你可以使用 RouteAttribute 特性来实现 action 重载,下面的代码片段展示了如何去实现。

public IActionResult Index() { return View(); } [Route("Home/Index/{i:int}")] public IActionResult Index(int i) { return View(); } [Route("Home/Index/{isDeleted:bool}")] public IActionResult Index(bool isDeleted) { return View(); }

使用 NonAction 特性 重载 action

你可以使用 NonActionAttribute 来标记某些方法,从而在运行时让 asp.net core 不把此方法 当作 action 对待,下面的代码展示了在 Index 上使用 NonActionAttribute 来实现 Index 的重载。

public IActionResult Index() { return View(); } [NonAction] public IActionResult Index(string text) { return View(); }

在 ASP.NET 5 中,如果两个 action 的名字一样,这就让运行时很尴尬,因为它是以 action 为单位,所以一定会返回运行时错误,还有一点要注意的是,Action 的名字 是不区分大小写的,也就是说:/Home/Index/HOME/INDEX 是一样的,所以通过 url 的变化切入到各个 重载方法 中,这是一个很有技巧的技术,解决办法就是通过本篇介绍的几种方式来完美实现!

译文链接:https://www.infoworld.com/article/3600190/how-to-overload-action-methods-in-aspnet-core-5-mvc.html

更多高质量干货:参见我的 GitHub: csharptranslate

,