如何在 ASP.NET Core 5 中重载 Action 方法

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();
        }
    }

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

  • Action 方法必须是 public
  • Action 不能是 static
  • Action 方法不能像 普通方法 一样可以参数重载

当你创建好 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 _logger;

        public HomeController(ILogger 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) 方法,编译器没有给出任何错误提示,然而把应用程序跑起来,你会遇到一个运行时错误,如下图所示:

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

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


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

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

使用 ActionName 特性 重载 action

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


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

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

使用 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/art...

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

你可能感兴趣的:(.net)