ASP.NET Core - Razor页面之Handlers处理方法

简介

在前一篇文章中，我们讨论了Razor页面。今天我们来谈谈处理方法（Handlers）。我们知道可以将代码和模型放在 .cshtml 文件里面或与 .cshtml 匹配的 .cshtml.cs 文件中。Razor页面处理程序或处理方法将用户请求匹配到我们的方法；请求来自 .cshtml 文件。Razor页面遵循特定的命名约定。从上一篇文章可以看出，.NET Core开发工具自动生成了很多处理方法，例如下面这些：

OnGet
OnPost
OnGetAsync
OnPostAsync
OnPostRemoveLoginAsync
OnGetLinkLoginCallbackAsync
etc..

从列表中，我们可以看到这些名称遵循的具体模式。它们都是从On开始，随后Get 或者Post，再其次是可选的 Handler名称 （RemoveLogin，LinkLoginCallback），最后Async后缀为异步方法。

示例项目可在GitHub上找到，需要使用最新的.NET Core 2.0.0 CLI。

默认POST和GET处理方法

打开页面将在代码背后触发默认的Get或GetAsync处理方法；类似地，提交表单将触发默认Post或PostAsync处理方法：

    <form method="POST"><div>Name: <input asp-for="Category.Name" /></div><div>Description: <input asp-for="Category.Description" /></div><button type="submit" class="btn btn-primary">Save</button></form>

触发的方法：

    public async Task<IActionResult> OnPostAsync()    {   
         if (!ModelState.IsValid){           
          return Page();}_dbContext.Categories.Add(Category);    
              await _dbContext.SaveChangesAsync();   
              return RedirectToPage("./Index");}

使用OnPostAsync或OnPost为处理方法名称都可以正常工作。如果您使用的是OnPost，那么代码中不能使用异步调用。

但是，如果您同时实现两种OnPostAsync和OnPOST等处理方法，您会遇到这样的问题：

自定义处理方法名称

除了默认的处理方法名称，我们还可以指定自定义名称。

在 .cshtml 文件中的实现以下代码：

    <form method="POST"><div>Description: <input asp-for="Category.Description" /></div><input type="submit" value="Save First" asp-page-handler="First" class="btn btn-primary btn-xs" /></form>

这会创建一个包含Description字段的简单表单：

在Razor页面中，将表单处理方法添加到匹配的 .cshtml.cs 文件代码文件，方法命名为：OnPostFirst 或 OnPostFirstAsync ，具体取决于要在其中运行的代码类型。假设我们需要在数据库中插入Category并保存这些更改，使用Entity Framework的异步方法：

    public async Task<IActionResult> OnPostFirstAsync()    {Category.Name = "First";_dbContext.Categories.Add(Category);    
        await _dbContext.SaveChangesAsync(); 
               return RedirectToPage("./Categories/Index");}

请注意名称 OnPost First Async 。

同一页面多个POST处理方法

让我们扩展刚才这一段代码，添加POST方法另一种形式：

下面是 .cshtml 的代码：

    <form method="POST"><div>Description: <input asp-for="Category.Description" /></div><input type="submit" value="Save First" asp-page-handler="First" class="btn btn-primary btn-xs" /></form><form method="POST"><div>Description: <input asp-for="Category.Description" /></div><input type="submit" value="Save Second" asp-page-handler="Second" class="btn btn-primary btn-xs" /></form>

这两个表单将分别匹配代码中这两种方法：

    public async Task<IActionResult> OnPostFirstAsync()    {      
      return await InsertCatepory("First");}   
      
    public async Task<IActionResult> OnPostSecondAsync()    {    
        return await InsertCatepory("Second");}  
        
    private async Task<IActionResult> InsertCatepory(string name)    {Category.Name = name;_dbContext.Categories.Add(Category); 
           await _dbContext.SaveChangesAsync();     
              return RedirectToPage("./Categories/Index");}

关键的代码是使用 asp-page-handler Tag Helper，指定表单的处理方法的名称。

我们也可以在一个表单通过两个提交按钮实现同样的事情：

    <form method="POST"><div>Description: <input asp-for="Category.Description" /></div><input type="submit" value="Save First" asp-page-handler="First" class="btn btn-primary btn-xs" /><input type="submit" value="Save Second" asp-page-handler="Second" class="btn btn-primary btn-xs" /></form>

处理方法参数

将参数传递给处理方法有两种方法：

表单输入
表单元素借助 asp-route Tag Helper

通过表单输入传递参数

对于表单输入作为输入参数，名称必须是同步的。HTML input元素的名称必须与处理方法参数的名称相匹配:

    <form method="POST"><input type="text" name="query"/><button type="submit" asp-page-handler="search">Search</button></form>

    public async Task OnPostSearchAsync(string query)    {Categories = await _dbContext.Categories.AsNoTracing().Where(c => !string.IsNullOrEmpty(c.Description) && c.Description.Contains(query)).ToListAsync();}

通过路由传递参数

以下是通过路由发送参数的两个示例：

    <div><form method="post" asp-page-handler="search" asp-route-query="Core">    <button>Search "Core"</button></form></div><div><form method="post" asp-page-handler="delete" asp-route-id="1"><button>Delete ID 1</button></form></div>

第一个是以前看到的search处理方法，它发送“Core”作为查询参数。

第二个是针对delete处理方法，并发送id为1，这表示它会删除第一条数据。

    public async Task OnPostSearchAsync(string query)    {Categories = await _dbContext.Categories.AsNoTracking().Where(c => !string.IsNullOrEmpty(c.Description) && c.Description.Contains(query)).ToListAsync();}   
    
     public async Task<IActionResult> OnPostDeleteAsync(int id)    {        var category = await _dbContext.Categories.FindAsync(id);      
      if (category != null) {_dbContext.Categories.Remove(category);        
          await _dbContext.SaveChangesAsync();}        return RedirectToPage();}