【ASP.NET MVC 学习笔记】- 17 Model验证
本文参考：http://www.cnblogs.com/willick/p/3434483.html
1、Model验证用于在实际项目中对用户提交的表单的信息进行验证，MVC对其提供了很好的支持。
2、ModelState 是 Controller 抽象类的一个属性，它是 MVC 处理完验证时要使用的一核心对象，提供了对验证结果的存、取和判断。所以验证用户提交的数据，最直接的方法是在Action方法中使用 ModelState 对Model对象的属性值自行判断合法性。示例：
[HttpPost] public ViewResult MakeBooking(Appointment appt) { if (string.IsNullOrEmpty(appt.ClientName)) { ModelState.AddModelError("ClientName", "Please enter your name"); //ModelState.AddModelError用于添加错误信息 } if (ModelState.IsValidField("Date") && DateTime.Now > appt.Date) //ModelState.IsValidField 方法用于检查用户提交的值是否能够被Model Binder成功赋值给指定的属性 { ModelState.AddModelError("Date", "Please enter a date in the future"); } if (!appt.TermsAccepted) { ModelState.AddModelError("TermsAccepted", "You must accept the terms"); } if (ModelState.IsValid) { return View("Completed", appt); } else { return View(); } }
3、验证消息的显示，可以简单的分为两种，一种是Model级的，另一种是属性级的。Model级示例：
@using (Html.BeginForm()) { @Html.ValidationSummary() <p>Your name: @Html.EditorFor(m => m.ClientName)</p> ... } //Html.ValidationSummary()还有三些重载方法：Html.ValidationSummary(bool) 、 Html.ValidationSummary(string) 和 Html.ValidationSummary(bool, string) 。
//第一个是当参数为true时，只显示Model级的验证消息（如果 ModelState.AddModelError 方法的第一个参数没有指定属性名称，则为Model级的）;第二个是为所有的验证消息显示一个标题;第三个是前两个的结合。
属性级示例：
@using (Html.BeginForm()) { @Html.ValidationSummary(true) <p>@Html.ValidationMessageFor(m => m.ClientName)</p> <p>Your name: @Html.EditorFor(m => m.ClientName)</p> <p>@Html.ValidationMessageFor(m => m.Date)</p> <p>Appointment Date: @Html.EditorFor(m => m.Date)</p> <p>@Html.ValidationMessageFor(m => m.TermsAccepted)</p> <p>@Html.EditorFor(m => m.TermsAccepted) I accept the terms & conditions</p> <input type="submit" value="Make Booking" /> }
4、处理在Action方法中进行验证，默认的ModelBinder在对值进行绑定时也有验证处理。示例：
[HttpPost] public ViewResult MakeBooking(Appointment appt) { if (ModelState.IsValid) { return View("Completed", appt); } else { return View(); } }
5、对于MVC模式来说，如果把验证的规则放在自定义的 Model Binder 类中似乎并不合适。更多的时候我们会选择使用元数据的方式把验证的规则放在Model类中。示例：
public class Appointment { [Required] public string ClientName { get; set; } [DataType(DataType.Date)] [Required(ErrorMessage="Please enter a date")] public DateTime Date { get; set; } [Range(typeof(bool), "true", "true", ErrorMessage = "You must accept the terms")] public bool TermsAccepted { get; set; } }
MVC内置的验证特性如下图:
6、我们也可以通过继承ValidationAttribute类自定义验证特性。示例：
public class MustBeTrueAttribute : ValidationAttribute { public override bool IsValid(object value) { return value is bool && (bool)value; } }
7、我们也可以继承内置的特性自定义验证特性。示例
public class FutureDateAttribute : RequiredAttribute { public override bool IsValid(object value) { return base.IsValid(value) && ((DateTime)value) > DateTime.Now; } }
8、Model级别的自定义验证。示例：
//Joe这个人星期一这天不能预约 public class NoJoeOnMondaysAttribute : ValidationAttribute { public NoJoeOnMondaysAttribute() { ErrorMessage = "Joe cannot book appointments on Mondays"; } public override bool IsValid(object value) { Appointment app = value as Appointment; if (app == null || string.IsNullOrEmpty(app.ClientName) || app.Date == null)
{ return true; }
else
{ return !(app.ClientName == "Joe" && app.Date.DayOfWeek == DayOfWeek.Monday); } } }
[NoJoeOnMondays] public class Appointment { ... }
9、Model 的自验证，即在 Model 类内部编写验证逻辑方法，通过实现 IValidatableObject 接口来告诉 MVC 该某个 Model 是否为自验证的 Model。示例：
public class Appointment : IValidatableObject
{ public string ClientName { get; set; } [DataType(DataType.Date)] public DateTime Date { get; set; } public bool TermsAccepted { get; set; } public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
{ List<ValidationResult> errors = new List<ValidationResult>(); if (string.IsNullOrEmpty(ClientName)) { errors.Add(new ValidationResult("Please enter your name")); } if (DateTime.Now > Date) { errors.Add(new ValidationResult("Please enter a date in the future")); } if (errors.Count == 0 && ClientName == "Joe" && Date.DayOfWeek == DayOfWeek.Monday) { errors.Add(new ValidationResult("Joe cannot book appointments on Mondays")); } if (!TermsAccepted) { errors.Add(new ValidationResult("You must accept the terms")); } return errors; } }
如果一个 Model 实现了 IValidatableObject 接口，MVC 会在 Model Binder 为 Model 的每个属性赋值后调用Validate方法。相对于在 Action 方法中的验证，这种 Model 自验证更为灵活，而且把验证逻辑放在对应的Model中，保证了代码的一致性，方便维护。
10、客户端验证在Web.config中有两个开关，默认都是启用的，如下：
<appSettings>
<add key="ClientValidationEnabled" value="true"/>
<add key="UnobtrusiveJavaScriptEnabled" value="true"/>
</appSettings>
要启用客户端验证，这两个值都需要设为true。你也可以在单个的View中通过设置HtmlHelper.ClientValidationEnabled 和 HtmlHelper.UnobtrusiveJavaScriptEnabled的值来开启或关闭客户端验证。启用时还需要包含三个JS引用：
- /Scripts/ jquery-1.7.1.min.js
- /Scripts/ jquery.validate.min.js
- /Scripts/ jquery.validate.unobtrusive.min.js
当我们启用客户端验证后，要使用起来，最简单的方便是对Model应用验证特性，如Required、Range等。为了演示，我们修改 Appointment 类如下：
public class Appointment
{
[Required]
[StringLength(10, MinimumLength = 3)]
public string ClientName { get; set; }
[DataType(DataType.Date)]
public DateTime Date { get; set; }
public bool TermsAccepted { get; set; }
}
这里的验证规则是通过后台指定的。但并不是所有后台使用的验证都有对应的客户端验证，例如 action 中的验证、应用Model级的验证特性和Model的自验证都是没有客户端验证的。
Tips：使用 MVC 提供的客户端验证的好处：不用写 JavaScript 代码；用户可以即时的看到验证消息，更快地得到反馈，如果用户禁用了JavaScript， MVC 就会走后台验证。
11、Remote 验证实际上就是通过 Ajax 实现的，只是被MVC封装好了，用起来简单多了，也不需要写 JavaScript 代码。示例：
//1、定义验证方法 public JsonResult ValidateDate(string Date) { DateTime parsedDate; if (!DateTime.TryParse(Date, out parsedDate)) { return Json("Please enter a valid date (yyyy/mm/dd)", JsonRequestBehavior.AllowGet); } else if (DateTime.Now > parsedDate) { return Json("Please enter a date in the future", JsonRequestBehavior.AllowGet); } else { return Json(true, JsonRequestBehavior.AllowGet); } } //2、使用 public class Appointment { public string ClientName { get; set; } [DataType(DataType.Date)] [Remote("ValidateDate", "Home")] public DateTime Date { get; set; } public bool TermsAccepted { get; set; } }
效果上和客户端验证差不多，但验证的处理是在 Controller 中的 Action 中发生的。应用 Remote 特性的字段，每次改变它的值都会调用一次后台，所以从某种意义上来说，我们应该尽量避免使用这种验证，除了那种不得不与后台交互的验证，如检查一个用户名是否已经存在。
