ASP.NET MVC4入门教程(六):验证编辑方法和编辑视图
在本节中,您将开始修改为电影控制器所新加的操作方法和视图。然后,您将添加一个自定义的搜索页。
在浏览器地址栏里追加/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文件 (地址在) 在 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模型,以及如何添加一个初始设定并自动创建一个测试数据库。