检查电影控制器的编辑操作方法和视图

项目
07/16/2024

注意

本教程的更新版本是使用最新版本的 Visual Studio 提供的。新教程使用 ASP.NET Core MVC，这为本教程提供了许多改进。

本教程介绍具有控制器和视图的 ASP.NET Core MVC。 Razor Pages 是 ASP.NET Core 中的一种新替代方法，它是一种基于页面的编程模型，使生成 Web UI 更加轻松高效。建议先尝试 Razor 页面教程，再使用 MVC 版本。 Razor 页面教程：

易于关注。
涵盖更多功能。
是新应用开发的首选方法。

在本部分中，你将检查电影控制器生成的 Edit 操作方法和视图。但首先，我们将采取一个简短的分流，使发布日期看起来更好。 打开 Models\Movie.cs 文件并添加下面所示突出显示的行：

using System;
using System.ComponentModel.DataAnnotations;
using System.Data.Entity;

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

        [Display(Name = "Release Date")]
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }

    public class MovieDBContext : DbContext
    {
        public DbSet<Movie> Movies { get; set; }
    }
}

还可以将日期区域性设置为如下所示：

[Display(Name = "Release Date")]
[DataType(DataType.Date)]
[DisplayFormat(DataFormatString = "{0:d}", ApplyFormatInEditMode = true)]
public DateTime ReleaseDate { get; set; }

我们将在下一教程中介绍 DataAnnotations。 Display 特性指定要显示的字段名称的内容（本例中应为“Release Date”，而不是“ReleaseDate”）。 DataType 属性指定数据类型，在本例中为日期，因此不会显示字段中存储的时间信息。 Chrome 浏览器中错误呈现日期格式的 bug 需要 DisplayFormat 属性。

运行应用程序并浏览到 Movies 控制器。将鼠标指针悬停在“编辑”链接上，以查看其链接到的 URL。

EditLink_sm

编辑链接是由 Html.ActionLink Views\Movies\Index.cshtml 视图中的方法生成的：

@Html.ActionLink("Edit", "Edit", new { id=item.ID })

Html.ActionLink

该Html对象是使用 System.Web.Mvc.WebViewPage 基类上的属性公开的帮助程序。借助 ActionLink 帮助程序的方法，可以轻松地动态生成链接到控制器上的操作方法的 HTML 超链接。方法的第一个参数 ActionLink 是要呈现的链接文本（例如， <a>Edit Me</a>）。第二个参数是要调用的操作方法的名称（在本例中 Edit 为操作）。最后一个参数是一个匿名对象，该对象生成路由数据（在本例中为 4）。

上图中显示的生成的链接为 http://localhost:1234/Movies/Edit/4。默认路由（在 App_Start\RouteConfig.cs 中建立）采用 URL 模式 {controller}/{action}/{id}。因此，ASP.NET 转换为http://localhost:1234/Movies/Edit/4控制器的操作方法Movies的请求Edit，参数ID等于 4。检查 App_Start\RouteConfig.cs 文件中的以下代码。 MapRoute 方法用于将 HTTP 请求路由到正确的控制器和操作方法，并提供可选的 ID 参数。 HtmlHelpers 也使用 MapRoute 方法，例如ActionLink，根据控制器、操作方法和任何路由数据生成 URL。

public static void RegisterRoutes(RouteCollection routes)
{
    routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

    routes.MapRoute(
        name: "Default",
        url: "{controller}/{action}/{id}",
        defaults: new { controller = "Home", action = "Index", 
            id = UrlParameter.Optional }
    );
}

还可以使用查询字符串传递操作方法参数。例如，URL http://localhost:1234/Movies/Edit?ID=3 还会将 3 的参数 ID 传递给 Edit 控制器的操作 Movies 方法。

EditQueryString

Movies打开控制器。下面显示了两 Edit 种操作方法。

// GET: /Movies/Edit/5
public ActionResult Edit(int? id)
{
    if (id == null)
    {
        return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
    }
    Movie movie = db.Movies.Find(id);
    if (movie == null)
    {
        return HttpNotFound();
    }
    return View(movie);
}

// POST: /Movies/Edit/5
// To protect from overposting attacks, please enable the specific properties you want to bind to, for 
// more details see https://go.microsoft.com/fwlink/?LinkId=317598.
[HttpPost]
[ValidateAntiForgeryToken]
public ActionResult Edit([Bind(Include="ID,Title,ReleaseDate,Genre,Price")] Movie movie)
{
    if (ModelState.IsValid)
    {
        db.Entry(movie).State = EntityState.Modified;
        db.SaveChanges();
        return RedirectToAction("Index");
    }
    return View(movie);
}

请注意第二个 Edit 操作方法的前面是 HttpPost 特性。此属性指定只能对 POST 请求调用该方法的 Edit 重载。可以将属性 HttpGet 应用于第一个编辑方法，但这不是必要的，因为它是默认值。（我们将引用隐式分配 HttpGet 属性为 HttpGet 方法的操作方法。 Bind 属性是另一个重要的安全机制，可阻止黑客将数据过度发布到模型。应仅将属性包含在要更改的绑定属性中。可以在我的超发安全说明中阅读关于过度发布和绑定属性的信息。在本教程中使用的简单模型中，我们将绑定模型中的所有数据。 ValidateAntiForgeryToken 属性用于防止伪造请求，并在编辑视图文件（Views\Movies\Edit.cshtml）中配对@Html.AntiForgeryToken()，如下所示：

@model MvcMovie.Models.Movie

@{
    ViewBag.Title = "Edit";
}
<h2>Edit</h2>
@using (Html.BeginForm())
{
    @Html.AntiForgeryToken()    
    <div class="form-horizontal">
        <h4>Movie</h4>
        <hr />
        @Html.ValidationSummary(true)
        @Html.HiddenFor(model => model.ID)

        <div class="form-group">
            @Html.LabelFor(model => model.Title, new { @class = "control-label col-md-2" })
            <div class="col-md-10">
                @Html.EditorFor(model => model.Title)
                @Html.ValidationMessageFor(model => model.Title)
            </div>
        </div>

@Html.AntiForgeryToken() 生成必须在控制器方法中 Edit 匹配的 Movies 隐藏形式防伪令牌。可以在 MVC 中的 XSRF/CSRF 防护教程中详细了解跨站点请求伪造（也称为 XSRF 或 CSRF）。

该方法HttpGetEdit采用电影 ID 参数，使用 Entity Framework Find 方法查找电影，并将所选电影返回到“编辑”视图。如果找不到电影，则返回 HttpNotFound 。当基架系统创建“编辑”视图时，它会检查 Movie 类并创建代码为类的每个属性呈现 <label> 和 <input> 元素。以下示例显示由 Visual Studio 基架系统生成的“编辑”视图：

@model MvcMovie.Models.Movie

@{
    ViewBag.Title = "Edit";
}
<h2>Edit</h2>
@using (Html.BeginForm())
{
    @Html.AntiForgeryToken()    
    <div class="form-horizontal">
        <h4>Movie</h4>
        <hr />
        @Html.ValidationSummary(true)
        @Html.HiddenFor(model => model.ID)

        <div class="form-group">
            @Html.LabelFor(model => model.Title, new { @class = "control-label col-md-2" })
            <div class="col-md-10">
                @Html.EditorFor(model => model.Title)
                @Html.ValidationMessageFor(model => model.Title)
            </div>
        </div>
        <div class="form-group">
            @Html.LabelFor(model => model.ReleaseDate, new { @class = "control-label col-md-2" })
            <div class="col-md-10">
                @Html.EditorFor(model => model.ReleaseDate)
                @Html.ValidationMessageFor(model => model.ReleaseDate)
            </div>
        </div>
        @*Genre and Price 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>
}
<div>
    @Html.ActionLink("Back to List", "Index")
</div>
@section Scripts {
    @Scripts.Render("~/bundles/jqueryval")
}

请注意视图模板在文件顶部的 @model MvcMovie.Models.Movie 语句的方式，这指定视图希望视图模板的模型的类型 Movie。

基架代码使用多个 帮助程序方法来 简化 HTML 标记。帮助 Html.LabelFor 程序显示字段的名称（“Title”、“ReleaseDate”、“流派”或“Price”）。帮助 Html.EditorFor 程序呈现 HTML <input> 元素。帮助 Html.ValidationMessageFor 程序显示与该属性关联的任何验证消息。

运行应用程序并导航到 /Movies URL。点击“编辑”链接。在浏览器中查看页面的源。窗体元素的 HTML 如下所示。

<form action="/movies/Edit/4" method="post">
   <input name="__RequestVerificationToken" type="hidden" value="UxY6bkQyJCXO3Kn5AXg-6TXxOj6yVBi9tghHaQ5Lq_qwKvcojNXEEfcbn-FGh_0vuw4tS_BRk7QQQHlJp8AP4_X4orVNoQnp2cd8kXhykS01" />  <fieldset class="form-horizontal">
      <legend>Movie</legend>

      <input data-val="true" data-val-number="The field ID must be a number." data-val-required="The ID field is required." id="ID" name="ID" type="hidden" value="4" />

      <div class="control-group">
         <label class="control-label" for="Title">Title</label>
         <div class="controls">
            <input class="text-box single-line" id="Title" name="Title" type="text" value="GhostBusters" />
            <span class="field-validation-valid help-inline" data-valmsg-for="Title" data-valmsg-replace="true"></span>
         </div>
      </div>

      <div class="control-group">
         <label class="control-label" for="ReleaseDate">Release Date</label>
         <div class="controls">
            <input class="text-box single-line" data-val="true" data-val-date="The field Release Date must be a date." data-val-required="The Release Date field is required." id="ReleaseDate" name="ReleaseDate" type="date" value="1/1/1984" />
            <span class="field-validation-valid help-inline" data-valmsg-for="ReleaseDate" data-valmsg-replace="true"></span>
         </div>
      </div>

      <div class="control-group">
         <label class="control-label" for="Genre">Genre</label>
         <div class="controls">
            <input class="text-box single-line" id="Genre" name="Genre" type="text" value="Comedy" />
            <span class="field-validation-valid help-inline" data-valmsg-for="Genre" data-valmsg-replace="true"></span>
         </div>
      </div>

      <div class="control-group">
         <label class="control-label" for="Price">Price</label>
         <div class="controls">
            <input class="text-box single-line" 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" type="text" value="7.99" />
            <span class="field-validation-valid help-inline" data-valmsg-for="Price" data-valmsg-replace="true"></span>
         </div>
      </div>

      <div class="form-actions no-color">
         <input type="submit" value="Save" class="btn" />
      </div>
   </fieldset>
</form>

元素 <input> 位于 HTML 元素中 <form> ，其 action 属性设置为发布到 /Movies/Edit URL。单击“保存”按钮时，表单数据将发布到服务器。第二行显示调用生成的@Html.AntiForgeryToken()隐藏的 XSRF 令牌。

处理 POST 请求

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

[HttpPost]
[ValidateAntiForgeryToken]
public ActionResult Edit([Bind(Include="ID,Title,ReleaseDate,Genre,Price")] Movie movie)
{
    if (ModelState.IsValid)
    {
        db.Entry(movie).State = EntityState.Modified;
        db.SaveChanges();
        return RedirectToAction("Index");
    }
    return View(movie);
}

ValidateAntiForgeryToken 属性验证视图中调用生成的 @Html.AntiForgeryToken() XSRF 令牌。

ASP.NET MVC 模型绑定器采用已发布的表单值，并创建Movie作为movie参数传递的对象。验证ModelState.IsValid表单中提交的数据是否可用于修改对象（编辑或更新）。Movie 如果数据有效，电影数据将Movies保存到（MovieDBContext实例）的db集合中。新的电影数据通过调用 SaveChanges 方法 MovieDBContext保存到数据库。保存数据后，代码将用户重定向到 MoviesController 类的 Index 操作方法，此方法显示电影集合，包括刚才所做的更改。

一旦客户端验证确定字段的值无效，就会显示一条错误消息。如果禁用 JavaScript，则禁用客户端验证。但是，服务器检测到已发布的值无效，表单值将重新显示错误消息。

本教程稍后将更详细地检查验证。

Html.ValidationMessageFor Edit.cshtml 视图模板中的帮助程序负责显示适当的错误消息。

abcNotValid

HttpGet所有方法都遵循类似的模式。它们获取电影对象（或对象列表（如果是）， Index并将模型传递给视图。该方法 Create 将空电影对象传递给“创建”视图。在方法的 HttpPost 重载中，创建、编辑、删除或以其他方式修改数据的所有方法都执行此操作。修改 HTTP GET 方法中的数据是一种安全风险，如博客文章文章 ASP.NET MVC 提示 #46 - 不要使用删除链接，因为它们创建了安全漏洞。修改 GET 方法中的数据也违反了 HTTP 最佳做法和体系结构 REST 模式，该模式指定 GET 请求不应更改应用程序的状态。换句话说，执行 GET 操作应是没有任何隐患的安全操作，也不会修改持久数据。

非英语区域设置的 jQuery 验证

如果使用美国英语计算机，可以跳过本部分并转到下一教程。可以在此处下载本教程的 Globalize 版本。有关国际化的两部分教程，请参阅 Nadeem 的 ASP.NET MVC 5 国际化。

注意

若要支持对使用逗号（“，”）的非英语区域设置的 jQuery 验证（“、”）小数点和非美国英语日期格式，则必须包含globalize.js和特定区域性/globalize.cultures.js文件（来自https://github.com/jquery/globalize）和 JavaScript 才能使用Globalize.parseFloat。可以从 NuGet 获取 jQuery 非英语验证。（如果你使用的是英语区域设置，请不要安装 Globalize。

在“工具”菜单中，单击“NuGet 程序包管理器”，然后单击“管理解决方案的 NuGet 包”。
在左窗格中，选择“ 浏览”*。*（请参阅下图。
在输入框中，输入 Globalize*。

选择 jQuery.Validation.Globalize，选择 MvcMovie 并单击“ 安装”。 Scripts\jquery.globalize\globalize.js 文件将添加到项目中。 *Scripts\jquery.globalize\cultures* 文件夹将包含许多区域性 JavaScript 文件。请注意，安装此包可能需要五分钟。

以下代码显示对 Views\Movies\Edit.cshtml 文件的修改：

@section Scripts {
    @Scripts.Render("~/bundles/jqueryval")

<script src="~/Scripts/globalize/globalize.js"></script>
<script src="~/Scripts/globalize/cultures/globalize.culture.@(System.Threading.Thread.CurrentThread.CurrentCulture.Name).js"></script>
<script>
    $.validator.methods.number = function (value, element) {
        return this.optional(element) ||
            !isNaN(Globalize.parseFloat(value));
    }
    $(document).ready(function () {
        Globalize.culture('@(System.Threading.Thread.CurrentThread.CurrentCulture.Name)');
    });
</script>
<script>
    jQuery.extend(jQuery.validator.methods, {
        range: function (value, element, param) {
            //Use the Globalization plugin to parse the value
            var val = Globalize.parseFloat(value);
            return this.optional(element) || (
                val >= param[0] && val <= param[1]);
        }
    });
    $.validator.methods.date = function (value, element) {
        return this.optional(element) ||
            Globalize.parseDate(value) ||
            Globalize.parseDate(value, "yyyy-MM-dd");
    }
</script>
}

若要避免在每个“编辑”视图中重复此代码，可以将其移动到布局文件。若要优化脚本下载，请参阅我的教程捆绑和缩小。

有关详细信息，请参阅 ASP.NET MVC 3 国际化和 ASP.NET MVC 3 国际化 - 第 2 部分（NerdDinner）。

作为临时修复程序，如果无法在区域设置中获取验证，则可以强制计算机使用美国英语，也可以在浏览器中禁用 JavaScript。若要强制计算机使用美国英语，可以将全球化元素添加到项目根 web.config 文件。以下代码显示了区域性设置为美国英语的全球化元素。

<system.web>
    <globalization culture ="en-US" />
    <!--elements removed for clarity-->
  </system.web>

在下一教程中，我们将实现搜索功能。

通过

检查电影控制器的编辑操作方法和视图

处理 POST 请求

非英语区域设置的 jQuery 验证

反馈

其他资源