验证编辑方法和编辑视图
在本节中,您将开始修改为电影控制器所新加的操作方法和视图。然后,您将添加一个自定义的搜索页。
在浏览器地址栏里追加/Movies, 浏览到Movies页面。并进入编辑(Edit)页面。
Edit (编辑) 链接是由 Views\Movies\Index.cshtml 视图中的 Html.ActionLink 方法所生成的:
@Html.ActionLink("Edit", "Edit", new { id=item.ID })
Html 对象是一个Helper, 以属性的形式, 在 System.Web.Mvc.WebViewPage 基类上公开。 ActionLink 是一个帮助方法,便于动态生成指向Controller中操作方法的HTML 超链接链接。 ActionLink 方法的第一个参数是想要呈现的链接文本 (例如, <a>Edit Me</a> )。第二个参数是要调用的操作方法的名称。最后一个参数是一个 匿名对象 ,用来生成路由数据 (在本例中,ID 为 4 的)。
在上图中所生成的链接是 http://localhost:xxxxx/Movies/Edit/4 默认的路由 (在 App_Start\RouteConfig.cs 中设定) 使用的 URL 匹配模式为: {controller}/{action}/{id} 。因此,ASP.NET 将 http://localhost:xxxxx/Movies/Edit/4 转化到 Movies 控制器中 Edit 操作方法,参数 ID 等于 4 的请求。查看 App_Start\RouteConfig.cs 文件中的以下代码。
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 } ); }
您还可以使用QueryString来传递操作方法的参数。例如,URL: http://localhost:xxxxx/Movies/Edit?ID=4 还会将参数 ID 为 4的请求传递给 Movies 控制器的 Edit 操作方法。
打开 Movies 控制器。如下所示的两个 Edit 操作方法。
// // GET: /Movies/Edit/5 public ActionResult Edit( int id = 0 ) { Movie movie = db.Movies.Find(id); if (movie == null ) { return HttpNotFound(); } return View(movie); } // // POST: /Movies/Edit/5 [HttpPost] public ActionResult Edit(Movie movie) { if (ModelState.IsValid) { db.Entry(movie).State = EntityState.Modified; db.SaveChanges(); return RedirectToAction( " Index " ); } return View(movie); }
注意,第二个 Edit 操作方法的上面有 HttpPost 属性。此属性指定了 Edit 方法的重载,此方法仅被POST 请求所调用。您可以将 HttpGet 属性应用于第一个编辑方法,但这是不必要的,因为它是默认的属性。(操作方法会被隐式的指定为 HttpGet 属性,从而作为 HttpGet 方法。)
HttpGet Edit 方法会获取电影ID参数、 查找影片使用Entity Framework 的 Find 方法,并返回到选定影片的编辑视图。如果不带参数调用 Edit 方法,ID 参数被指定为 默认值 零。如果找不到一部电影,则返回 HttpNotFound 。当VS自动创建编辑视图时,它会查看 Movie 类并为类的每个属性创建用于Render的 <label> 和 <input> 的元素。下面的示例为自动创建的编辑视图:
@model MvcMovie.Models.Movie @{ ViewBag.Title = "Edit"; } < h2 > Edit </ h2 > @using (Html.BeginForm()) { @Html.ValidationSummary(true) < fieldset > < legend > Movie </ legend > @Html.HiddenFor(model => model.ID) < div class ="editor-label" > @Html.LabelFor(model => model.Title) </ div > < div class ="editor-field" > @Html.EditorFor(model => model.Title) @Html.ValidationMessageFor(model => model.Title) </ div > < div class ="editor-label" > @Html.LabelFor(model => model.ReleaseDate) </ div > < div class ="editor-field" > @Html.EditorFor(model => model.ReleaseDate) @Html.ValidationMessageFor(model => model.ReleaseDate) </ div > < div class ="editor-label" > @Html.LabelFor(model => model.Genre) </ div > < div class ="editor-field" > @Html.EditorFor(model => model.Genre) @Html.ValidationMessageFor(model => model.Genre) </ div > < div class ="editor-label" > @Html.LabelFor(model => model.Price) </ div > < div class ="editor-field" > @Html.EditorFor(model => model.Price) @Html.ValidationMessageFor(model => model.Price) </ div > < p > < input type ="submit" value ="Save" /> </ p > </ fieldset > } < div > @Html.ActionLink("Back to List", "Index") </ div > @section Scripts { @Scripts.Render("~/bundles/jqueryval") }
注意,视图模板在文件的顶部有 @model MvcMovie.Models.Movie 的声明,这将指定视图期望的模型类型为 Movie 。
自动生成的代码,使用了Helper方法的几种简化的 HTML 标记。 Html.LabelFor 用来显示字段的名称("Title"、"ReleaseDate"、"Genre"或"Price")。 Html.EditorFor 用来呈现 HTML <input> 元素。 Html.ValidationMessageFor 用来显示与该属性相关联的任何验证消息。
运行该应用程序,然后浏览URL,/Movies。单击 Edit 链接。在浏览器中查看页面源代码。HTML Form中的元素如下所示:
< form action ="/Movies/Edit/4" method ="post" > < fieldset > < 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 ="editor-label" > < label for ="Title" > Title </ label > </ div > < div class ="editor-field" > < input class ="text-box single-line" id ="Title" name ="Title" type ="text" value ="Rio Bravo" /> < span class ="field-validation-valid" data-valmsg-for ="Title" data-valmsg-replace ="true" ></ span > </ div > < div class ="editor-label" > < label for ="ReleaseDate" > ReleaseDate </ label > </ div > < div class ="editor-field" > < input class ="text-box single-line" data-val ="true" data-val-date ="The field ReleaseDate must be a date." data-val-required ="The ReleaseDate field is required." id ="ReleaseDate" name ="ReleaseDate" type ="text" value ="4/15/1959 12:00:00 AM" /> < span class ="field-validation-valid" data-valmsg-for ="ReleaseDate" data-valmsg-replace ="true" ></ span > </ div > < div class ="editor-label" > < label for ="Genre" > Genre </ label > </ div > < div class ="editor-field" > < input class ="text-box single-line" id ="Genre" name ="Genre" type ="text" value ="Western" /> < span class ="field-validation-valid" data-valmsg-for ="Genre" data-valmsg-replace ="true" ></ span > </ div > < div class ="editor-label" > < label for ="Price" > Price </ label > </ div > < div class ="editor-field" > < 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 ="2.99" /> < span class ="field-validation-valid" data-valmsg-for ="Price" data-valmsg-replace ="true" ></ span > </ div > < p > < input type ="submit" value ="Save" /> </ p > </ fieldset > </ form >
被 <form> HTML 元素所包括的 <input> 元素会被发送到,form的 action 属性所设置的URL:/Movies/Edit。单击 Edit 按钮时,from数据将会被发送到服务器。
处理 POST 请求下面的代码显示了 Edit 操作方法的 HttpPost 处理:
[HttpPost] public ActionResult Edit(Movie movie) { if (ModelState.IsValid) { db.Entry(movie).State = EntityState.Modified; db.SaveChanges(); return RedirectToAction( " Index " ); } return View(movie); }
ASP.NET MVC 模型绑定 接收form所post的数据,并转换所接收的 movie 请求数据从而创建一个 Movie 对象。 ModelState.IsValid 方法用于验证提交的表单数据是否可用于修改(编辑或更新)一个 Movie 对象。如果数据是有效的电影数据,将保存到数据库的 Movies 集合 (MovieDBContext instance)。通过调用 MovieDBContext 的 SaveChanges 方法,新的电影数据会被保存到数据库。数据保存之后,代码会把用户重定向到 MoviesController 类的 Index 操作方法,页面将显示电影列表,同时包括刚刚所做的更新。
如果form发送的值不是有效的值,它们将重新显示在form中。 Edit.cshtml 视图模板中的 Html.ValidationMessageFor Helper将用来显示相应的错误消息。
注意 ,为了使jQuery支持使用逗号的非英语区域的验证 ,需要设置逗号(",")来表示小数点,你需要引入 globalize.js 并且你还需要具体的指定 cultures/globalize.cultures.js 文件 (地址在 https://github.com/jquery/globalize ) 在 JavaScript 中可以使用 Globalize.parseFloat 。下面的代码展示了在"FR-FR" Culture下的 Views\Movies\Edit.cshtml 视图:
@section Scripts { @Scripts.Render( "~/bundles/jqueryval" ) <script src="~/Scripts/globalize.js"></script> <script src="~/Scripts/globalize.culture.fr-FR.js"></script> <script> $.validator.methods.number = function (value, element) { return this .optional(element) || ! isNaN(Globalize.parseFloat(value)); } $(document).ready( function () { Globalize.culture( 'fr-FR' ); }); </script> <script> jQuery.extend(jQuery.validator.methods, { range: function (value, element, param) { // Use the Globalization plugin to parse the value var val = $.global.parseFloat(value); return this .optional(element) || ( val >= param[0] && val <= param[1 ]); } }); </script> }
十进制字段可能需要逗号,而不是小数点。作为临时的修复,您可以向项目根 web.config 文件添加的全球化设置。下面的代码演示设置为美国英语的全球化文化设置。
<system.web>
<globalization culture ="en-US" />
<!--elements removed for clarity-->
</system.web>
所有 HttpGet 方法都遵循类似的模式。它们获取影片对象 (或对象集合,如 Index 里的对象集合),并将模型传递给视图。 Create 方法将一个空的Movie对象传递给创建视图。创建、 编辑、 删除或以其它方式修改数据的方法都是 HttpPost 方法。使用HTTP GET 方法来修改数据是存在安全风险,在 ASP.NET MVC Tip #46 – Don’t use Delete Links because they create Security Holes 的Blog中有完整的叙述。在 GET 方法中修改数据还违反了 HTTP 的最佳做法和 Rest 架构模式, GET 请求不应更改应用程序的状态。换句话说,执行 GET 操作,应该是一种安全的操作,没有任何副作用,不会修改您持久化的数据。
添加一个搜索方法和搜索视图在本节中,您将添加一个搜索电影流派或名称的 SearchIndex 操作方法。这将可使用 /Movies/SearchIndex URL。该请求将显示一个 HTML 表单,其中包含输入的元素,用户可以输入一部要搜索的电影。当用户提交窗体时,操作方法将获取用户输入的搜索条件并在数据库中搜索。
显示 SearchIndex 窗体通过将 SearchIndex 操作方法添加到现有的 MoviesController 类开始。该方法将返回一个视图包含一个 HTML 表单。如下代码:
public ActionResult SearchIndex( string searchString) { var movies = from m in db.Movies select m; if (! String.IsNullOrEmpty(searchString)) { movies = movies.Where(s => s.Title.Contains(searchString)); } return View(movies); }
SearchIndex 方法的第一行创建以下的 LINQ 查询,以选择看电影:
var movies = from m in db.Movies select m;
查询在这一点上,只是定义,并还没有执行到数据上。
如果 searchString 参数包含一个字符串,可以使用下面的代码,修改电影查询要筛选的搜索字符串:
if (! String.IsNullOrEmpty(searchString)) { movies = movies.Where(s => s.Title.Contains(searchString)); }
上面 s => s.Title 代码是一个 Lambda 表达式 。Lambda 是基于方法的 LINQ 查询,(例如上面的where查询)在上面的代码中使用了标准查询参数运算符的方法。当定义LINQ查询或修改查询条件时(如调用 Where 或 OrderBy 方法时,不会执行 LINQ 查询。相反,查询执行会被延迟,这意味着表达式的计算延迟,直到取得实际的值或调用 ToList 方法。在 SearchIndex 示例中,SearchIndex 视图中执行查询。有关延迟的查询执行的详细信息,请参阅 Query Execution .
现在,您可以实现 SearchIndex 视图并将其显示给用户。在 SearchIndex 方法内单击右键,然后单击 添加视图 。在 添加视图 对话框中,指定你要将 Movie 对象传递给视图模板作为其模型类。在 框架模板 列表中,选择 列表 ,然后单击 添加 .
当您单击 添加 按钮时,创建了 Views\Movies\SearchIndex.cshtml 视图模板。因为你选中了 框架模板 的列表,Visual Studio 将自动生成 列表 视图中的某些默认标记。框架模版创建了 HTML 表单。它会检查 Movie 类,并为类的每个属性创建用来展示的 <label> 元素。下面是生成的视图:
@model IEnumerable < MvcMovie .Models.Movie > @{ ViewBag.Title = "SearchIndex"; } < h2 > SearchIndex </ h2 > < p > @Html.ActionLink("Create New", "Create") </ p > < table > < tr > < th > Title </ th > < th > ReleaseDate </ th > < th > Genre </ th > < th > Price </ th > < th ></ th > </ tr > @foreach (var item in Model) { < tr > < td > @Html.DisplayFor(modelItem => item.Title) </ td > < td > @Html.DisplayFor(modelItem => item.ReleaseDate) </ td > < td > @Html.DisplayFor(modelItem => item.Genre) </ td > < td > @Html.DisplayFor(modelItem => item.Price) </ td > < td > @Html.ActionLink("Edit", "Edit", new { id=item.ID }) | @Html.ActionLink("Details", "Details", new { id=item.ID }) | @Html.ActionLink("Delete", "Delete", new { id=item.ID }) </ td > </ tr > } </ table >
运行该应用程序,然后转到 /Movies/SearchIndex 。追加查询字符串到URL如 ?searchString=ghost 。显示已筛选的电影。
如果您更改 SearchIndex 方法的签名,改为参数 id ,在 Global.asax 文件中设置的默认路由将使得: id 参数将匹配 {id} 占位符。
{controller}/{action}/{id}
原来的 SearchIndex 方法看起来是这样的:
public ActionResult SearchIndex( string searchString) { var movies = from m in db.Movies select m; if (! String.IsNullOrEmpty(searchString)) { movies = movies.Where(s => s.Title.Contains(searchString)); } return View(movies); }
修改后的 SearchIndex 方法将如下所示:
public ActionResult SearchIndex( string id) { string searchString = id; var movies = from m in db.Movies select m; if (! String.IsNullOrEmpty(searchString)) { movies = movies.Where(s => s.Title.Contains(searchString)); } return View(movies); }
您现在可以将搜索标题作为路由数据 (部分URL) 来替代QueryString。
但是,每次用户想要搜索一部电影时, 你不能指望用户去修改 URL。所以,现在您将添加 UI页面,以帮助他们去筛选电影。如果您更改了的 SearchIndex 方法来测试如何传递路由绑定的 ID 参数,更改它,以便您的 SearchIndex 方法采用字符串 searchString 参数:
public ActionResult SearchIndex( string searchString) { var movies = from m in db.Movies select m; if (! String.IsNullOrEmpty(searchString)) { movies = movies.Where(s => s.Title.Contains(searchString)); } return View(movies); }
打开 Views\Movies\SearchIndex.cshtml 文件,并在 @Html.ActionLink("Create New", "Create") 后面,添加以下内容:
@using (Html.BeginForm()){ <p> Title: @Html.TextBox("SearchString")<br /> <input type="submit" value="Filter" /></p> }
下面的示例展示了添加后, Views\Movies\SearchIndex.cshtml 文件的一部分:
@model IEnumerable<MvcMovie.Models.Movie> @{ ViewBag.Title = "SearchIndex" ; } <h2>SearchIndex</h2> <p> @Html.ActionLink( "Create New", "Create" ) @using (Html.BeginForm()){ <p> Title: @Html.TextBox("SearchString") <br /> <input type="submit" value="Filter" /></p> } </p>
Html.BeginForm Helper 创建开放 <form> 标记。 Html.BeginForm Helper将使得, 在用户通过单击 筛选 按钮提交窗体时,窗体Post本Url。运行该应用程序,请尝试搜索一部电影。
SearchIndex 没有 HttpPost 的重载方法。你并不需要它,因为该方法并不更改应用程序数据的状态,只是筛选数据。
您可以添加如下的 HttpPost SearchIndex 方法。在这种情况下,请求将进入 HttpPost SearchIndex 方法, HttpPost SearchIndex 方法将返回如下图的内容。
[HttpPost] public string SearchIndex(FormCollection fc, string searchString) { return " <h3> From [HttpPost]SearchIndex: " + searchString + " </h3> " ; }
但是,即使您添加此 HttpPost SearchIndex 方法,这一实现其实是有局限的。想象一下您想要添加书签给特定的搜索,或者您想要把搜索链接发送给朋友们,他们可以通过单击看到一样的电影搜索列表。请注意 HTTP POST 请求的 URL 和GET 请求的URL 是相同的(localhost:xxxxx/电影/SearchIndex)— — 在 URL 中没有搜索信息。现在,搜索字符串信息作为窗体字段值,发送到服务器。这意味着您不能在 URL 中捕获此搜索信息,以添加书签或发送给朋友。
解决方法是使用重载的 BeginForm ,它指定 POST 请求应添加到 URL 的搜索信息,并应该路由到 HttpGet SearchIndex 方法。将现有的无参数 BeginForm 方法,修改为以下内容:
@using (Html.BeginForm("SearchIndex","Movies",FormMethod.Get))
现在当您提交搜索,该 URL 将包含搜索的查询字符串。搜索还会请求到 HttpGet SearchIndex 操作方法,即使您也有一个 HttpPost SearchIndex 方法。
按照电影流派添加搜索
如果您添加了 HttpPost 的 SearchIndex 方法,请立即删除它。
接下来,您将添加功能可以让用户按流派搜索电影。将 SearchIndex 方法替换成下面的代码:
public ActionResult SearchIndex( string movieGenre, string searchString) { var GenreLst = new List< string > (); var GenreQry = from d in db.Movies orderby d.Genre select d.Genre; GenreLst.AddRange(GenreQry.Distinct()); ViewBag.movieGenre = new SelectList(GenreLst); var movies = from m in db.Movies select m; if (! String.IsNullOrEmpty(searchString)) { movies = movies.Where(s => s.Title.Contains(searchString)); } if ( string .IsNullOrEmpty(movieGenre)) return View(movies); else { return View(movies.Where(x => x.Genre == movieGenre)); } }
这版的 SearchIndex 方法将接受一个附加的 movieGenre 参数。前几行的代码会创建一个 List 对象来保存数据库中的电影流派。
下面的代码是从数据库中检索所有流派的 LINQ 查询。
var GenreQry = from d in db.Movies orderby d.Genre select d.Genre;
该代码使用泛型 List 集合的 AddRange 方法将所有不同的流派,添加到集合中的。(使用 Distinct 修饰符,不会添加重复的流派 -- 例如,在我们的示例中添加了两次喜剧)。该代码然后在 ViewBag 对象中存储了流派的数据列表。
下面的代码演示如何检查 movieGenre 参数。如果它不是空的,代码进一步指定了所查询的电影流派。
if ( string .IsNullOrEmpty(movieGenre)) return View(movies); else { return View(movies.Where(x => x.Genre == movieGenre)); }在SearchIndex 视图中添加选择框支持按流派搜索
在 TextBox Helper之前添加 Html.DropDownList Helper到 Views\Movies\SearchIndex.cshtml 文件中。添加完成后,如下面所示:
< p > @Html.ActionLink("Create New", "Create") @using (Html.BeginForm("SearchIndex","Movies",FormMethod.Get)){ < p > Genre: @Html.DropDownList("movieGenre", "All") Title: @Html.TextBox("SearchString") < input type ="submit" value ="Filter" /></ p > } </ p >
运行该应用程序并浏览 /Movies/SearchIndex 。按流派、 按电影名,或者同时这两者,来尝试搜索。
在这一节中您修改了CRUD 操作方法和框架所生成的视图。您创建了一个搜索操作方法和视图,让用户可以搜索电影标题和流派。在下一节中,您将看到如何将属性添加到 Movie 模型,以及如何添加一个初始设定并自动创建一个测试数据库。
--------------------------------------------------------------------------------------------------------------------
译者注:
本系列共9篇文章,翻译自Asp.Net MVC4 官方教程,由于本系列文章言简意赅,篇幅适中,从一个示例开始讲解,全文最终完成了一个管理影片的小系统,非常适合新手入门Asp.Net MVC4,并由此开始开发工作。9篇文章为:
1. Asp.Net MVC4 入门介绍
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/intro-to-aspnet-mvc-4
· 译文地址: http://www.cnblogs.com/powertoolsteam/archive/2012/11/01/2749906.html
2. 添加一个控制器
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/adding-a-controller
· 译文地址: http://www.cnblogs.com/powertoolsteam/archive/2012/11/02/2751015.html
3. 添加一个视图
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/adding-a-view
· 译文地址: http://www.cnblogs.com/powertoolsteam/archive/2012/11/06/2756711.html
4. 添加一个模型
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/adding-a-model
· 译文地址: http://www.cnblogs.com/powertoolsteam/archive/2012/12/17/2821495.html
5. 从控制器访问数据模型
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/accessing-your-models-data-from-a-controller
· 译文地址: http://www.cnblogs.com/powertoolsteam/archive/2013/01/11/2855935.html
6. 验证编辑方法和编辑视图
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/examining-the-edit-methods-and-edit-view
· 译文地址:http://www.cnblogs.com/powertoolsteam/archive/2013/01/24/2874622.html
7. 给电影表和模型添加新字段
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/adding-a-new-field-to-the-movie-model-and-table
· 译文地址:
8. 给数据模型添加校验器
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/adding-validation-to-the-model
· 译文地址:
9. 查询详细信息和删除记录
· 原文地址: http://www.asp.net/mvc/tutorials/mvc-4/getting-started-with-aspnet-mvc4/examining-the-details-and-delete-methods
· 译文地址:
葡萄城控件产品网站: http://www.gcpowertools.com.cn/
葡萄城技术支持论坛: http://gcdn.grapecity.com/
分类: Web技术
作者: Leo_wl
出处: http://www.cnblogs.com/Leo_wl/
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
版权信息