.net mvc Model 验证总结

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显示。

另外，也能够引用自带的样式。让提示框更美观。