ASP.NET MVC4中的Model是自验证的,这是通过.NET4的System.ComponentModel.DataAnnotations命名空间完毕的。 我们要做的仅仅是给Model类的各属性加上相应的验证标记(Attributes)就能够让MVC4框架帮我们完毕验证。我以MVC4项目模板自带的登录做样例解说Model的验证。
一、启用client验证:
client验证主要是为了提高用户体验,在网页不回刷的情况下完毕验证。
第一步是要在web.config里启用client验证,这在MVC4自带的模板项目中已经有了:
<add key="ClientValidationEnabled" value="true"/> <add key="UnobtrusiveJavaScriptEnabled" value="true"/>然后在被验证的View页面上要增加这样两个JavaScript,注意,他们是依赖于JQuery的:
<script src="@Url.Content("~/Scripts/jquery.validate.min.js")" type="text/javascript"></script> <script src="@Url.Content("~/Scripts/jquery.validate.unobtrusive.min.js")" type="text/javascript"></script>验证消息的显示有两种,一种是ValidationSummary,它能够显示一份验证消息的汇总,包含从后台Action里返回的消息。
@Html.ValidationSummary(true) @Html.ValidationSummary(true, "Login was unsuccessful. Please correct the errors and try again.")还有一种是Model中各属性相应HTML控件的验证消息:
@Html.ValidationMessageFor(m => m.UserName)
二、在Model中增加验证标记
MVC4项目模板自带的登录模型类例如以下:public class LogOnModel { [Required] [Display(Name = "User name")] public string UserName { get; set; } [Required] [DataType(DataType.Password)] [Display(Name = "Password")] public string Password { get; set; } [Display(Name = "Remember me?")] public bool RememberMe { get; set; } }对照普通的C#类,我们发现每一个属性上都多了被方括号“[ ]”包围的标记。
当中。[Required]是验证标记的一种,而[Display]、[DataType]则是为了显示相应的HTML控件,这不在本文讨论范围之内。
除了Required,我们还能够在Model中加入其它实用的验证标记。以下是个较完整的列表:
Model类中能够加入的验证标记:
1. 必填字段
[Required]
public string FirstName { get; set; }
2. 字段长度
至多n位:
[StringLength(160)]
public string FirstName { get; set; }
要求至少n位:
[StringLength(160, MinimumLength=3)]
public string FirstName { get; set; }
3. 正则验证
[RegularExpression(@”[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+.[A-Za-z]{2,4}”)]
public string Email { get; set; }
4. 范围
[Range(35,44)]
public int Age { get; set; }
小数的情况:
[Range(typeof(decimal), “0.00”, “49.99”)]
public decimal Price { get; set; }
5. 服务端參与的验证
[Remote(“CheckUserName”, “Account”)]
public string UserName { get; set; }
然后在AccountController里指定一个CheckUserName方法:
public JsonResult CheckUserName(string username) { var result = Membership.FindUsersByName(username).Count == 0; return Json(result, JsonRequestBehavior.AllowGet); }
6. 比較
[RegularExpression(@”[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+.[A-Za-z]{2,4}”)]
public string Email { get; set; }
[Compare(“Email”)]
public string EmailConfirm { get; set; }
7. 自己定义错误消息
正则:
[RegularExpression(@”[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+.[A-Za-z]{2,4}”,
ErrorMessage=”Email doesn’t look like a valid email address.”)]
public string Email { get; set; }
普通文本:
[Required(ErrorMessage="Your last name is required")]
[StringLength(160, ErrorMessage=”Your last name is too long”)]
public string LastName { get; set; }
占位符:
[Required(ErrorMessage=”Your {0} is required.”)]
[StringLength(160, ErrorMessage=”{0} is too long.”)]
public string LastName { get; set; }
三、后台Action的写法
Action里要做的有两件事:推断ModelState是否合法、加入错误消息。MVC4模板自带的登录Action例如以下:
[HttpPost] public ActionResult LogOn(LogOnModel model, string returnUrl) { if (ModelState.IsValid) { if (Membership.ValidateUser(model.UserName, model.Password)) { FormsAuthentication.SetAuthCookie(model.UserName, model.RememberMe); if (Url.IsLocalUrl(returnUrl) && returnUrl.Length > 1 && returnUrl.StartsWith("/") && !returnUrl.StartsWith("//") && !returnUrl.StartsWith("/\")) { return Redirect(returnUrl); } else { return RedirectToAction("Index", "Home"); } } else { ModelState.AddModelError("", "The user name or password provided is incorrect."); } } // If we got this far, something failed, redisplay form return View(model); }[HttpPost]表示这个Action仅仅能通过POST动作调用,这是为了配合View里的表单。由于FORM的ACTION是POST(当然也能够是GET)。只是这不在本文的讨论范围内。
if (ModelState.IsValid) 是重点,假设不出意外,即client浏览器没有关闭JavaScript。而且客户不是个黑客(黑客可能会通过一些工具模拟POST),那仅仅要通过正常途径 POST到这个Action的Model都应该是IsValid的。当然,编程的一个重要原则是不能相信用户的输入。所以我们有必要再推断一次 ModelState.IsValid。
ModelState.AddModelError方法是给View返回一个错误消息,终于交给@Html.ValidationSummary显示。
另外,也能够引用自带的样式。让提示框更美观。
<link
rel="stylesheet"
type="text/css"
href="/Content/css/Site.css"/>