创建ASP.NET Core MVC应用程序(5)-添加查询功能 & 新字段
添加查询功能
本文将实现通过Name查询用户信息。
首先更新GetAll
方法以启用查询:
public async Task> GetAll(string searchString){ var users = from u in _context.Users select u; if (!string.IsNullOrEmpty(searchString)) { users = users.Where(u => u.Name.Contains(searchString)); } return await users.ToListAsync();}
第一行的LINQ查询仅仅在这里作了定义,并没有在这里实际操作数据库。
LINQ查询在被定义或者通过调用类似于Where
、Contains
、OrderBy
的方法进行修改的时候不会执行。相反的,查询会延迟执行,比如在ToListAsync
方法被调用之后。
Contains
方法会在数据库中运行,而不是上面的C#代码,在数据库中,Contains
会被映射成不区分大小写的SQLLIKE
。
由于u => u.Name.Contains(searchString)
Lambda表达式在当前我所使用的MySQL Connector/NET版本中运行报错(新版本好像已经修复了该问题,这里懒得更新了),所以这里先改成:
users = users.Where(u => u.Name == searchString);
导航到http://localhost:5000/User
,添加?searchString=Zhu
查询字符串,将过滤出指定的用户信息(http://localhost:5000/User?searchString=Zhu
)。
如果你修改Index
方法的签名使得方法包含一个名为id
的参数,那么id
参数将会匹配Startup.cs文件中设置的默认路由的可选项{id?}
。
app.UseMvc(routes =>{ routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}");});
Rename后的方法:
public async TaskIndex(string id){ var users = from u in _context.Users select u; if (!String.IsNullOrEmpty(id)) { users = users.Where(u => u.Name == id); } return View(await users.ToListAsync());}
现在你可以传递这个Name查询条件作为路由数据(URL Segment)来代替查询字符串(http://localhost:5000/User/Index/Zhu
)。
然而,我们不能指望用户每次都通过修改URL来进行查询,我们通过添加UI来进行查询。如果你想改变Index
方法的签名来测试怎样传递路由绑定ID
参数,将searchString
参数改回来。
接着,打开Views/User/Index.cshtml文件,添加<form>
标记:
这里HTML<form>
标签使用了Form Tag Helper,所以当你提交这个表单时,过滤字符串会被传递到User控制器的Index
方法中。
这里没有使用你所希望的[HttpPost] Index
重载方法,其实根本不需要该方法,因为这个方法并没有改变这个应用的状态,仅仅用来过滤数据。
你可以添加下面的[HttpPost] Index
方法。
[HttpPost]public string Index(string searchString, bool notUsed){ return "From [HttpPost]Index: filter on " + searchString;}
notUsed
参数用于创建一个重载的Index
方法。如果你添加了该方法,动作方法将会调用匹配的[HttpPost] Index
方法。
这个时候点击过滤按钮时,会显示如下界面:
然而,尽管你添加了[HttpPost]
版本的Index
方法,最终仍然存在局限性。想象你将一个指定的查询作为书签或者将查询结果作为一个链接发送给你的朋友以便他们在打开时能看到同样的过滤结果时,注意HTTP POST请求的URL和GET请求的URL(http://localhost:5000/User
)是一样的-在URL里面没有任何查询信息。查询信息是作为发送到服务器的。
在请求体中可以看到查询参数和XSRF反伪造标记(通过Form Tag Helper生成),由于查询没有修改数据,所以无需在控制器方法中验证该标记。
为了把查询参数从请求体中移到URL中,必须把请求指定为HTTP GET
。
此时当你再提交时,URL将会包含具体的查询条件。查询将会跳转到HttpGet Index
方法,即使存在着HttpPost Index
方法。
添加新的字段
我们将通过Entity Framework Code First Migrations工具来添加一个新的字段到模型中,并将新的改变同步到数据库中。
当你使用EF Code First自动创建一个数据库时,Code First会添加一个表到数据库中帮助跟踪数据库的数据结构是否和模型类保持同步。如果不同步,EF会抛出一个异常。
添加身高属性到模型类
public class User{ public int ID { get; set; } [Display(Name = "姓名")] public string Name { get; set; } [Display(Name = "邮箱")] [DataType(DataType.EmailAddress)] public string Email { get; set; } [Display(Name = "简介")] public string Bio { get; set; } // 新添加的属性 [Display(Name = "身高")] public decimal Height { get; set; } [Display(Name = "职称")] public string Title { get; set; } [Display(Name = "部门")] public string Dept { get; set; }}
Build该应用(dotnet build
)。可能由于我所使用的MySQL EF Core provider还不成熟,添加DateTime
类型的字段时会报错(新版本可能会修复该问题,这里懒得去测试了)。
由于你添加了一个新的字段到User
类,所以你需要更新所绑定的白名单,这样新的属性将会包含这内。为Create
和Edit
方法更新[Bind]
特性以包含Height
属性。
[Bind("ID,Name,Email,Bio,Height,Title,Dept")]
为了显示新的字段还要更新视图模板。
打开Index.cshtml、Create.cshtml、Edit.cshtml等文件,添加新的Height
字段。
然后需要更新数据库以包含新的字段。如果没有更新,此时运行将报错,因为更新后User模型类和已存在的数据库User表的结构不一致。
有以下几种方案来解决该错误:
EF可以基于新的模型类自动删除并重建数据库。开发阶段在测试数据库上做开发还是比较方便的,但是你会丢失数据库中的现有数据。因此该方案不适用于生产环境数据库!
显式修改现有数据库的结构,使得它与模型类相匹配,这个方案可以让你保留数据库的现有数据。你可以通过手动或者数据库脚本来进行变更。
使用Code First Migrations来更新数据库结构。
这里采用第三种方案,运行如下命令:
dotnet ef migrations add Heightdotnet ef database update
migrations add
命令告诉Migration框架去检查当前的User
模型类和当前的User
数据库表结构是否一致。如果不一致,就创建必要的代码来迁移数据库到新的模型类。
基于新添加的“部门”字段进行查询
在Models目录下添加UserDeptViewModel
类:
using Microsoft.AspNetCore.Mvc.Rendering;public class UserDeptViewModel{ public Listusers; public SelectList depts; public string userDept { get; set; }}
这个视图模型(View Model)将包含:
- 用户列表
users
。 - 包含部门列表(depts)的
SelectList
,将用于视图页面中允许用户去从列表中选择一个部门。 userDept
,包含用户所选中的部门(dept)。
修改Index
方法:
public async TaskIndex(string userDept, string searchString){ IQueryable deptQuery = from u in _context.Users orderby u.Dept select u.Dept; var users = from u in _context.Users select u; if (!String.IsNullOrEmpty(searchString)) { users = users.Where(u => u.Name == searchString); } if (!String.IsNullOrEmpty(userDept)) { users = users.Where(u => u.Dept == userDept); } var userDeptVM = new UserDeptViewModel(); userDeptVM.depts = new SelectList(await deptQuery.Distinct().ToListAsync()); userDeptVM.users = await users.ToListAsync(); return View(userDeptVM);}
下面的代码通过LINQ查询从数据库获取所有的部门数据。
IQueryabledeptQuery = from u in _context.Users orderby u.Dept select u.Dept;
depts的SelectList
是通过投影不重复的部门(Distinct
)创建的。
userDeptVM.depts = new SelectList(await deptQuery.Distinct().ToListAsync());
在Index视图中添加“部门”查询字段
首先删除最顶部的@model:
@model IEnumerable<MyFirstApp.Models.User>
替换成:
@model UserDeptViewModel
在<form>
标记中添加:
在<table>
标记中分别删除:
@Html.DisplayNameFor(model => model.Dept)
@foreach (var item in Model) {
替换成:
@Html.DisplayNameFor(model => model.users[0].Dept)@foreach (var item in Model.users) {
最终的Index.cshtml文件如下:
@model UserDeptViewModel@{ ViewData["Title"] = "Index - User List";}首页 - 用户列表
@Html.DisplayNameFor(model => model.users[0].Name) | @Html.DisplayNameFor(model => model.users[0].Email) | @Html.DisplayNameFor(model => model.users[0].Height) | @Html.DisplayNameFor(model => model.users[0].Title) | @Html.DisplayNameFor(model => model.users[0].Dept) | @Html.DisplayNameFor(model => model.users[0].Bio) | |
---|---|---|---|---|---|---|
@Html.DisplayFor(modelItem => item.Name) | @Html.DisplayFor(modelItem => item.Email) | @Html.DisplayFor(modelItem => item.Height) | @Html.DisplayFor(modelItem => item.Title) | @Html.DisplayFor(modelItem => item.Dept) | @Html.DisplayFor(modelItem => item.Bio) | 编辑 | 详情 | 删除 |
最终运行的页面: