閱讀(4.5k) 書簽贊(0) 我要糾錯

ASP.NET Core 中的控制器方法和視圖

2021-06-15 15:37 更新

電影應(yīng)用的開頭不錯，但展示效果不理想，例如，ReleaseDate 應(yīng)為兩個詞。

打開 Models/Movie.cs 文件，并添加以下代碼中突出顯示的行：

using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace MvcMovie.Models
{
    public class Movie
    {
        public int Id { get; set; }
        public string Title { get; set; }

        [Display(Name = "Release Date")]
        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }

        [Column(TypeName = "decimal(18, 2)")]
        public decimal Price { get; set; }
    }
}

下一教程將介紹 DataAnnotations。 Display 特性指定要顯示的字段名稱的內(nèi)容（本例中應(yīng)為“Release Date”，而不是“ReleaseDate”）。 DataType 屬性指定數(shù)據(jù)的類型（日期），使字段中存儲的時間信息不會顯示。

要使 Entity Framework Core 能將 Price 正確地映射到數(shù)據(jù)庫中的貨幣，則必須使用 [Column(TypeName = "decimal(18, 2)")] 數(shù)據(jù)注釋。有關(guān)詳細信息，請參閱數(shù)據(jù)類型。

瀏覽到 Movies 控制器，并將鼠標指針懸停在“編輯”鏈接上以查看目標 URL。

鼠標懸停在“編輯”鏈接上的瀏覽器窗口，顯示了 https://localhost:5001/Movies/Edit/5 的鏈接 URL

“編輯”、“詳細信息”和“刪除”鏈接是在 Views/Movies/Index.cshtml 文件中由 Core MVC 定位標記幫助程序生成的。

CSHTML

        <a asp-action="Edit" asp-route-id="@item.ID">Edit</a> |
        <a asp-action="Details" asp-route-id="@item.ID">Details</a> |
        <a asp-action="Delete" asp-route-id="@item.ID">Delete</a>
    </td>
</tr>

標記幫助程序使服務(wù)器端代碼可以在 Razor 文件中參與創(chuàng)建和呈現(xiàn) HTML 元素。在上面的代碼中，AnchorTagHelper 從控制器操作方法和路由 ID 動態(tài)生成 HTML href 特性值。在最喜歡的瀏覽器中使用“查看源”，或使用開發(fā)人員工具來檢查生成的標記。生成的 HTML 的一部分如下所示：

HTML

 <td>
    <a href="/Movies/Edit/4"> Edit </a> |
    <a href="/Movies/Details/4"> Details </a> |
    <a href="/Movies/Delete/4"> Delete </a>
</td>

重新調(diào)用在 Startup.cs 文件中設(shè)置的路由的格式：

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});

ASP.NET Core 將 https://localhost:5001/Movies/Edit/4 轉(zhuǎn)換為對 Movies 控制器的 Edit 操作方法的請求，參數(shù) Id 為 4。（控制器方法也稱為操作方法。）

標記幫助程序是 ASP.NET Core 中最受歡迎的新功能之一。有關(guān)詳細信息，請參閱其他資源。

打開 Movies 控制器并檢查兩個 Edit 操作方法。以下代碼顯示了 HTTP GET Edit 方法，此方法將提取電影并填充由 Edit.cshtml Razor 文件生成的編輯表單。

// GET: Movies/Edit/5
public async Task<IActionResult> Edit(int? id)
{
    if (id == null)
    {
        return NotFound();
    }

    var movie = await _context.Movie.FindAsync(id);
    if (movie == null)
    {
        return NotFound();
    }
    return View(movie);
}

以下代碼顯示 HTTP POST Edit 方法，它會處理已發(fā)布的電影值：

// POST: Movies/Edit/5
// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see http://go.microsoft.com/fwlink/?LinkId=317598.
[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie)
{
    if (id != movie.ID)
    {
        return NotFound();
    }

    if (ModelState.IsValid)
    {
        try
        {
            _context.Update(movie);
            await _context.SaveChangesAsync();
        }
        catch (DbUpdateConcurrencyException)
        {
            if (!MovieExists(movie.ID))
            {
                return NotFound();
            }
            else
            {
                throw;
            }
        }
        return RedirectToAction("Index");
    }
    return View(movie);
}

[Bind] 特性是防止過度發(fā)布的一種方法。只應(yīng)在 [Bind] 特性中包含想要更改的屬性。有關(guān)詳細信息，請參閱防止控制器過度發(fā)布。 ViewModels 提供了一種替代方法以防止過度發(fā)布。

請注意第二個 Edit 操作方法的前面是 [HttpPost] 特性。

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie)
{
    if (id != movie.ID)
    {
        return NotFound();
    }

    if (ModelState.IsValid)
    {
        try
        {
            _context.Update(movie);
            await _context.SaveChangesAsync();
        }
        catch (DbUpdateConcurrencyException)
        {
            if (!MovieExists(movie.ID))
            {
                return NotFound();
            }
            else
            {
                throw;
            }
        }
        return RedirectToAction(nameof(Index));
    }
    return View(movie);
}

HttpPost 特性指定只能為 POST 請求調(diào)用此 Edit 方法。可將 [HttpGet] 屬性應(yīng)用于第一個編輯方法，但不是必需，因為 [HttpGet] 是默認設(shè)置。

ValidateAntiForgeryToken 特性用于防止請求偽造，并與編輯視圖文件 (Views/Movies/Edit.cshtml) 中生成的防偽標記相配對。編輯視圖文件使用表單標記幫助程序生成防偽標記。

CSHTML

<form asp-action="Edit">

表單標記幫助程序會生成隱藏的防偽標記，此標記必須與電影控制器的 Edit 方法中 [ValidateAntiForgeryToken] 生成的防偽標記相匹配。有關(guān)詳細信息，請參閱防止跨站點請求偽造 (XSRF/CSRF) Core 中的 ASP.NET 攻擊。

HttpGet Edit 方法采用電影 ID 參數(shù)，使用Entity Framework FindAsync 方法查找電影，并將所選電影返回到“編輯”視圖。如果無法找到電影，則返回 NotFound (HTTP 404)。

// GET: Movies/Edit/5
public async Task<IActionResult> Edit(int? id)
{
    if (id == null)
    {
        return NotFound();
    }

    var movie = await _context.Movie.FindAsync(id);
    if (movie == null)
    {
        return NotFound();
    }
    return View(movie);
}

當基架系統(tǒng)創(chuàng)建“編輯”視圖時，它會檢查 Movie 類并創(chuàng)建代碼為類的每個屬性呈現(xiàn) <label> 和 <input> 元素。以下示例顯示由 Visual Studio 基架系統(tǒng)生成的“編輯”視圖：

CSHTML

@model MvcMovie.Models.Movie

@{
    ViewData["Title"] = "Edit";
}

<h1>Edit</h1>

<h4>Movie</h4>
<hr />
<div class="row">
    <div class="col-md-4">
        <form asp-action="Edit">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <input type="hidden" asp-for="Id" />
            <div class="form-group">
                <label asp-for="Title" class="control-label"></label>
                <input asp-for="Title" class="form-control" />
                <span asp-validation-for="Title" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="ReleaseDate" class="control-label"></label>
                <input asp-for="ReleaseDate" class="form-control" />
                <span asp-validation-for="ReleaseDate" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Genre" class="control-label"></label>
                <input asp-for="Genre" class="form-control" />
                <span asp-validation-for="Genre" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Price" class="control-label"></label>
                <input asp-for="Price" class="form-control" />
                <span asp-validation-for="Price" class="text-danger"></span>
            </div>
            <div class="form-group">
                <input type="submit" value="Save" class="btn btn-primary" />
            </div>
        </form>
    </div>
</div>

<div>
    <a asp-action="Index">Back to List</a>
</div>

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

請注意視圖模板在文件頂端有一個 @model MvcMovie.Models.Movie 語句。 @model MvcMovie.Models.Movie 指定視圖期望的視圖模板的模型為 Movie 類型。

基架的代碼使用幾個標記幫助程序方法來簡化 HTML 標記。標簽標記幫助程序顯示字段的名稱（“Title”、“ReleaseDate”、“Genre”或“Price”）。輸入標記幫助程序呈現(xiàn) HTML <input> 元素。驗證標記幫助程序顯示與該屬性相關(guān)聯(lián)的任何驗證消息。

運行應(yīng)用程序并導航到 /Movies URL。點擊“編輯”鏈接。在瀏覽器中查看頁面的源。為 <form> 元素生成的 HTML 如下所示。

HTML

<form action="/Movies/Edit/7" method="post">
    <div class="form-horizontal">
        <h4>Movie</h4>
        <hr />
        <div class="text-danger" />
        <input type="hidden" data-val="true" data-val-required="The ID field is required." id="ID" name="ID" value="7" />
        <div class="form-group">
            <label class="control-label col-md-2" for="Genre" />
            <div class="col-md-10">
                <input class="form-control" type="text" id="Genre" name="Genre" value="Western" />
                <span class="text-danger field-validation-valid" data-valmsg-for="Genre" data-valmsg-replace="true"></span>
            </div>
        </div>
        <div class="form-group">
            <label class="control-label col-md-2" for="Price" />
            <div class="col-md-10">
                <input class="form-control" type="text" data-val="true" data-val-number="The field Price must be a number." data-val-required="The Price field is required." id="Price" name="Price" value="3.99" />
                <span class="text-danger field-validation-valid" data-valmsg-for="Price" data-valmsg-replace="true"></span>
            </div>
        </div>
        <!-- Markup removed for brevity -->
        <div class="form-group">
            <div class="col-md-offset-2 col-md-10">
                <input type="submit" value="Save" class="btn btn-default" />
            </div>
        </div>
    </div>
    <input name="__RequestVerificationToken" type="hidden" value="CfDJ8Inyxgp63fRFqUePGvuI5jGZsloJu1L7X9le1gy7NCIlSduCRx9jDQClrV9pOTTmqUyXnJBXhmrjcUVDJyDUMm7-MF_9rK8aAZdRdlOri7FmKVkRe_2v5LIHGKFcTjPrWPYnc9AdSbomkiOSaTEg7RU" />
</form>

<input> 元素位于 HTML <form> 元素中，后者的 action 特性設(shè)置為發(fā)布到 /Movies/Edit/id URL。當單擊 Save 按鈕時，表單數(shù)據(jù)將發(fā)布到服務(wù)器。關(guān)閉 </form> 元素之前的最后一行顯示表單標記幫助程序生成的隱藏的 XSRF 標記。

處理 POST 請求

以下列表顯示了 Edit 操作方法的 [HttpPost] 版本。

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Edit(int id, [Bind("ID,Title,ReleaseDate,Genre,Price")] Movie movie)
{
    if (id != movie.ID)
    {
        return NotFound();
    }

    if (ModelState.IsValid)
    {
        try
        {
            _context.Update(movie);
            await _context.SaveChangesAsync();
        }
        catch (DbUpdateConcurrencyException)
        {
            if (!MovieExists(movie.ID))
            {
                return NotFound();
            }
            else
            {
                throw;
            }
        }
        return RedirectToAction(nameof(Index));
    }
    return View(movie);
}

[ValidateAntiForgeryToken] 特性驗證表單標記幫助程序中的防偽標記生成器生成的隱藏的 XSRF 標記

模型綁定系統(tǒng)采用發(fā)布的表單值，并創(chuàng)建一個作為 movie 參數(shù)傳遞的 Movie 對象。 ModelState.IsValid 屬性驗證表單中提交的數(shù)據(jù)是否可以用于修改（編輯或更新）Movie 對象。如果數(shù)據(jù)有效，將保存此數(shù)據(jù)。通過調(diào)用數(shù)據(jù)庫上下文的 SaveChangesAsync 方法，將更新（編輯）的電影數(shù)據(jù)保存到數(shù)據(jù)庫。保存數(shù)據(jù)后，代碼將用戶重定向到 MoviesController 類的 Index 操作方法，此方法顯示電影集合，包括剛才所做的更改。

在表單發(fā)布到服務(wù)器之前，客戶端驗證會檢查字段上的任何驗證規(guī)則。如果有任何驗證錯誤，則將顯示錯誤消息，并且不會發(fā)布表單。如果禁用 JavaScript，則不會進行客戶端驗證，但服務(wù)器將檢測無效的發(fā)布值，并且表單值將與錯誤消息一起重新顯示。稍后在本教程中，我們將更詳細地研究模型驗證。 Views/Movies/Edit.cshtml 視圖模板中的驗證標記幫助程序負責顯示相應(yīng)的錯誤消息。

“編輯”視圖：不正確的“價格”值 abc 的異常，說明“價格”字段必須是一個數(shù)字。不正確的“發(fā)布日期”值 xyz 的異常，請輸入有效的日期。

電影控制器中的所有 HttpGet 方法都遵循類似的模式。它們獲取電影對象（對于 Index獲取的是對象列表）并將對象（模型）傳遞給視圖。 Create 方法將空的電影對象傳遞給 Create 視圖。在方法的 [HttpPost] 重載中，創(chuàng)建、編輯、刪除或以其他方式修改數(shù)據(jù)的所有方法都執(zhí)行此操作。以 HTTP GET 方式修改數(shù)據(jù)是一種安全隱患。以 HTTP GET 方法修改數(shù)據(jù)也違反了 HTTP 最佳做法和架構(gòu) REST 模式，后者指定 GET 請求不應(yīng)更改應(yīng)用程序的狀態(tài)。換句話說，執(zhí)行 GET 操作應(yīng)是沒有任何隱患的安全操作，也不會修改持久數(shù)據(jù)。

其他資源

全球化和本地化
標記幫助程序簡介
創(chuàng)作標記幫助程序
防止跨站點請求偽造 (XSRF/CSRF) Core 中的 ASP.NET 攻擊
防止控制器過度發(fā)布
ViewModels
表單標記幫助程序
輸入標記幫助程序
標簽標記幫助程序
選擇標記幫助程序
驗證標記幫助程序

以上內(nèi)容是否對您有幫助：

← 在 ASP.NET Core 中使用 SQL

將搜索添加到 ASP.NET Core MVC 應(yīng)用 →

寫筆記

我要補充

ASP.NET Core 中的控制器方法和視圖

處理 POST 請求

其他資源

推薦文章

推薦教程

推薦課程