asp.net mvc3 資料驗證（三）—自訂資料註解

前兩節講的都是asp.net mvc3預先設定的資料註解，但是系統自由的資料註解肯定不適合所有的場合，所以有時候我們需要自訂資料註解。         自訂資料註解有兩種，一種是直接寫在模型對象中，這樣做的好處是驗證時只需要關心一種模型對象的驗證邏輯，缺點也是顯而易見的，那就是不能重用。                                             還有一種是封裝在自訂的資料註解中，優點是可重用，缺點是需要應對不同類型的模型。         現在我們以封裝在自訂資料註解中的方法為例看下如何在asp.net mvc3中自訂資料註解以及使用。   一、自訂屬性層級的驗證         首先，所有的資料註解都應繼承於 System.ComponentModel.DataAnnotations命名空間中的 ValidationAttribute類。             重寫其 protected virtual ValidationResult IsValid(object value, ValidationContext validationContext); 例如：         我們需要寫一個UserName不能超過10個字母的資料註解（你可能會說這不是有的 StringLength麼，好吧，僅以此為例，我真沒想到其他的需要自訂資料註解的好例子）。         (1)建立一個類 MaxLengthAttribute，代碼如下：

    public class MyMaxLengthAttribute : ValidationAttribute    {        private readonly int MaxLength;         public MyMaxLengthAttribute(int maxLength)        {            MaxLength = maxLength;        }         protected override ValidationResult IsValid(object value, ValidationContext validationContext)        {            string content = value.ToString();            if (content.Length > MaxLength)            {                return new ValidationResult("輸入的字元太多了。^_^");            }            return ValidationResult.Success;            //return base.IsValid(value, validationContext);        }

        第二步就是像正常使用asp.net內建的資料註解一樣使用，如：         

        [Required(ErrorMessageResourceType=typeof(ErrorMessage),ErrorMessageResourceName="UserRequire")]        [Display(Name = "使用者名稱")]        [MyMaxLengthAttribute(10)]        [Remote("CheckUserName","Account", HttpMethod="POST")]        public string UserName { get; set; }

        好了，只需要這樣簡單的兩步就可以實現了。

驗證結果：         對於自訂的資料註解由於是繼承於 System.ComponentModel.DataAnnotations命名空間中的 ValidationAttribute類，所以它的一些屬性也可以使用，比如ErrorMessage，如：

        [Required(ErrorMessageResourceType=typeof(ErrorMessage),ErrorMessageResourceName="UserRequire")]        [Display(Name = "使用者名稱")]        [MyMaxLengthAttribute(10,ErrorMessage="{0}字數太多")]        [Remote("CheckUserName","Account", HttpMethod="POST")]        public string UserName { get; set; }

        需要注意的是，自訂的資料註解不支援用戶端驗證，所有的資料需要提交之後再服務端驗證，所以如果要同時實現用戶端驗證需要自己寫js驗證。   但是這樣的驗證有一個問題，就是預設的驗證資訊不能實現直接顯示Display Name，所以需要如下更改：

    public class MyMaxLengthAttribute : ValidationAttribute    {        private readonly int MaxLength;         public MyMaxLengthAttribute(int maxLength ):base("{0}的字元太多了!")        {            MaxLength = maxLength;        }         protected override ValidationResult IsValid(object value, ValidationContext validationContext)        {            string content = value.ToString();            if (content.Length > MaxLength)            {                //return new ValidationResult("輸入的字元太多了。^_^");                string errorMessage = FormatErrorMessage(validationContext.DisplayName);                 return new ValidationResult(errorMessage);            }            return ValidationResult.Success;            //return base.IsValid(value, validationContext);        }    }

   驗證結果：

  二、自訂Model層級的驗證（IValidatableObject）         這個介面是為了實現Model的自驗證（self-validating）的，是asp.net mvc3 新增的驗證特性。這個特性和普通資料註解的區別是普通資料註解僅僅只能驗證Model的一個屬性，而實現了IValidatableObject介面的自驗證則在Model的層級來驗證，比如驗證Model的幾個屬性之間的關係等。         例如，我要驗證兩次輸入的密碼相同（好吧，我又把系統內建的驗證再寫一遍）。         (1)首先，要將需要驗證的Model實現IValidatableObject介面。      public class RegisterModel : IValidatableObject         (2)在Model中實現 Validate方法：

        public IEnumerable<ValidationResult> Validate(ValidationContext validationContent)        {            if (Password != ConfirmPassword)            {                yield return new ValidationResult("兩次輸入的密碼不同。", new[] { "Password" });            }        }

          這個方法在提交Model時會自動驗證兩次輸入的密碼是否相同，如果不同則會提示，如下：

  注意：1、自驗證只能把方法寫在需要驗證的Model中，所以這種自驗證的代碼無法重用；             2、自驗證的傳回值是 IEnumerable<ValidationResult>，而不是 ValidationResult，所以傳回值可以不止一個驗證錯誤。             3、Validate方法沒有傳入value參數，也就是意味著Validate方法可以直接存取Model中的屬性值。             4、傳回值使用的是yield return來構建枚舉傳回值，第二個參數是指定錯誤資訊綁定的屬性，因為是string數組，所以可以關聯多個屬性。

最後附上常用Regex

數字："^[0-9]*$"。

n位的數字："^\d{n}$"。

至少n位的數字："^\d{n,}$"。

m~n位的數字：。"^\d{m,n}$"

零和非零開頭的數字："^(0|[1-9][0-9]*)$"。

有兩位小數的正實數："^[0-9]+(.[0-9]{2})?$"。

有1~3位小數的正實數："^[0-9]+(.[0-9]{1,3})?$"。

非零的正整數："^\+?[1-9][0-9]*$"。

非零的負整數："^\-[1-9][]0-9"*$。

長度為3的字元："^.{3}$"。

由26個英文字母組成的字串："^[A-Za-z]+$"。

由26個大寫英文字母組成的字串："^[A-Z]+$"。

由26個小寫英文字母組成的字串："^[a-z]+$"。

由數字和26個英文字母組成的字串："^[A-Za-z0-9]+$"。

由數字、26個英文字母或者底線組成的字串："^\w+$"。

驗證使用者密碼："^[a-zA-Z]\w{5,17}$"正確格式為：以字母開頭，長度在6~18之間，只能包含字元、數字和底線。

驗證是否含有^%&’,;=?$\"等字元："[^%&’,;=?$\x22]+"。

只能輸入漢字："^[\u4e00-\u9fa5]{0,}$"

驗證Email地址："^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$"。

驗證InternetURL："^http://([\w-]+\.)+[\w-]+(/[\w-./?%&=]*)?$"。

驗證電話號碼："^(\(\d{3,4}-)|\d{3.4}-)?\d{7,8}$"正確格式為："XXX-XXXXXXX"、"XXXX- XXXXXXXX"、"XXX-XXXXXXX"、"XXX-XXXXXXXX"、"XXXXXXX"和"XXXXXXXX"。

驗證社會安全號碼(15位或18位元字)："^\d{15}|\d{18}$"。

驗證一年的12個月："^(0?[1-9]|1[0-2])$"正確格式為："01"～"09"和"1"～"12"。

驗證一個月的31天："^((0?[1-9])|((1|2)[0-9])|30|31)$"正確格式為;"01"～"09"和"1"～"31"。