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

原文：《ASP.NET Core Razor Pages – Handler Methods》https://codingblast.com/asp-net-core-razor-pages-handlers/
翻譯：Sweet Tang
本文地址：http://www.cnblogs.com/tdfblog/p/razor-pages-handlers-in-asp-net-core.html
歡迎轉載，請在明顯位置給出出處及鏈接。