建站
咨詢
售后
建站咨詢
新聞中心
ASP.NET MVC采用Model綁定為目標(biāo)Action生成了相應(yīng)的參數(shù)列表，但是在真正執(zhí)行目標(biāo)Action方法之前，還需要對綁定的參數(shù)實施驗證以確保其有效性，我們將針對參數(shù)的驗證成為Model綁定?？偟貋碚f，我們可以采用4種不同的編程模式來進(jìn)行針對綁定參數(shù)的驗證。
創(chuàng)新互聯(lián)建站專注為客戶提供全方位的互聯(lián)網(wǎng)綜合服務(wù)，包含不限于網(wǎng)站建設(shè)、成都做網(wǎng)站、勐海網(wǎng)絡(luò)推廣、微信小程序開發(fā)、勐海網(wǎng)絡(luò)營銷、勐海企業(yè)策劃、勐海品牌公關(guān)、搜索引擎seo、人物專訪、企業(yè)宣傳片、企業(yè)代運(yùn)營等，從售前售中售后，我們都將竭誠為您服務(wù)，您的肯定，是我們最大的嘉獎；創(chuàng)新互聯(lián)建站為所有大學(xué)生創(chuàng)業(yè)者提供勐海建站搭建服務(wù)，24小時服務(wù)熱線：13518219792，官方網(wǎng)址：www.cdcxhl.com
一、手工驗證綁定的參數(shù)
在定義具體Action方法的時候，對已經(jīng)成功綁定的參數(shù)實施手工驗證無疑是一種最為直接的編程方式，接下來我們通過一個簡單的實例來演示如何將參數(shù)驗證邏輯實現(xiàn)在對應(yīng)的Action方法中，并在沒有通過驗證的情況下將錯誤信息響應(yīng)給客戶端。我們在一個ASP.NET MVC應(yīng)用中定義了如下一個Person類作為被驗證的數(shù)據(jù)類型，它的Name、Gender和Age三個屬性分別表示一個人的姓名、性別和年齡。
- public class Person
- {
- [DisplayName("姓名")]
- public string Name { get; set; }
- [DisplayName("性別")]
- public string Gender { get; set; }
- [DisplayName("年齡")]
- public int? Age { get; set; }
- }
接下來我們定義了如下一個HomeController。在針對GET請求的Action方法Index中，我們創(chuàng)建了一個Person對象并將其作為Model呈現(xiàn)在對應(yīng)的View中。另一個支持POST請求的Index方法具有一個Person類型的參數(shù)，我們在該Action方法中先調(diào)用Validate方法對這個輸入?yún)?shù)實施驗證。如果驗證成功（ModeState.IsValid屬性返回True），我們返回一個內(nèi)容為“輸入數(shù)據(jù)通過驗證”的ContentResult，否則將此參數(shù)作為Model呈現(xiàn)在對應(yīng)的View中。
- public class HomeController : Controller
- {
- [HttpGet]
- public ActionResult Index()
- {
- return View(new Person());
- }
- [HttpPost]
- public ActionResult Index(Person person)
- {
- Validate(person);
- if (!ModelState.IsValid)
- {
- return View(person);
- }
- else
- {
- return Content("輸入數(shù)據(jù)通過驗證");
- }
- }
- private void Validate(Person person)
- {
- if (string.IsNullOrEmpty(person.Name))
- {
- ModelState.AddModelError("Name", "'Name'是必需字段");
- }
- if (string.IsNullOrEmpty(person.Gender))
- {
- ModelState.AddModelError("Gender", "'Gender'是必需字段");
- }
- else if (!new string[] { "M", "F" }.Any(
- g => string.Compare(person.Gender, g, true) == 0))
- {
- ModelState.AddModelError("Gender",
- "有效'Gender'必須是'M','F'之一");
- }
- if (null == person.Age)
- {
- ModelState.AddModelError("Age", "'Age'是必需字段");
- }
- else if (person.Age > 25 || person.Age < 18)
- {
- ModelState.AddModelError("Age", "有效'Age'必須在18到25周歲之間");
- }
- }
- }
如上面的代碼片斷所示，我們在Validate該方法中我們對作為參數(shù)的Person對象的3個屬性進(jìn)行逐條驗證，如果提供的數(shù)據(jù)沒有通過驗證，我們會調(diào)用當(dāng)前ModelState的AddModelError方法將指定的驗證錯誤消息轉(zhuǎn)換為ModelError保存起來。我們采用的具體的驗證規(guī)則如下。
- Person對象的Name、Gender和Age屬性均為必需字段，不能為Null（或者空字符串）。
- 表示性別的Gender屬性的值必需是“M”（Male）或者“F”（Female），其余的均為無效值。
- Age屬性表示的年齡必須在18到25周歲之間。
如下所示的是Action方法Index對應(yīng)View的定義，這是一個Model類型為Person的強(qiáng)類型View，它包含一個用于編輯人員信息的表單。我們直接調(diào)用HtmlHelper
- @model Person
編輯人員信息 - @using (Html.BeginForm())
- {
- @Html.EditorForModel()
- }
直接運(yùn)行該程序后，一個用于編輯人員基本信息的頁面會被呈現(xiàn)出來，如果我們在輸入不合法的數(shù)據(jù)并提交后，相應(yīng)的驗證信息會以圖1所示的形式呈現(xiàn)出來。
二、使用ValidationAttribute特性
將針對輸入?yún)?shù)的驗證邏輯和業(yè)務(wù)邏輯定義在Action方法中并不是一種值得推薦的編程方式。在大部分情況下，同一個數(shù)據(jù)類型在不同的應(yīng)用場景中具有相同的驗證規(guī)則，如果我們能將驗證規(guī)則與數(shù)據(jù)類型關(guān)聯(lián)在一起，讓框架本身來實施數(shù)據(jù)驗證，那么最終的開發(fā)者就可以將關(guān)注點(diǎn)更多地放在業(yè)務(wù)邏輯的實現(xiàn)上面。實際上這也是ASP.NET MVC的Model驗證系統(tǒng)默認(rèn)支持的編程方式。當(dāng)我們在定義數(shù)據(jù)類型的時候，可以在類型及其數(shù)據(jù)成員上面應(yīng)用相應(yīng)的ValidationAttribute特性來定義默認(rèn)采用的驗證規(guī)則。
“System.ComponentModel.DataAnnotations”命名空間定義了一系列具體的ValidationAttribute特性類型，它們大都可以直接應(yīng)用在自定義數(shù)據(jù)類型的某個屬性上對目標(biāo)數(shù)據(jù)成員實施驗證。這些預(yù)定義驗證特性不是本章論述的重點(diǎn)，我們會在“下篇”中對它們作一個概括性的介紹。
常規(guī)驗證可以通過上面列出的這些預(yù)定義ValidationAttribute特性來完成，但是在很多情況下我們需要通過創(chuàng)建自定義的ValidationAttribute特性來解決一些特殊的驗證。比如上面演示實例中針對Person對象的驗證中，我們要求Gender屬性指定的表示性別的值必須是“M/m”和“F/f”兩者之一，這樣的驗證就不得不通過自定義的ValidationAttribute特性來實現(xiàn)。
針對 “某個值必須在指定的范圍內(nèi)”這樣的驗證規(guī)則，我們定義一個DomainAttribute特性。如下面的代碼片斷所示，DomainAttribute具有一個IEnumerable
- [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field, AllowMultiple = false)]
- public class DomainAttribute : ValidationAttribute
- {
- public IEnumerable
Values { get; private set; } - public DomainAttribute(string value)
- {
- this.Values = new string[] { value };
- }
- public DomainAttribute(params string[] values)
- {
- this.Values = values;
- }
- public override bool IsValid(object value)
- {
- if (null == value)
- {
- return true;
- }
- return this.Values.Any(item => value.ToString() == item);
- }
- public override string FormatErrorMessage(string name)
- {
- string[] values = this.Values.Select(value => string.Format("'{0}'", value)).ToArray();
- return string.Format(base.ErrorMessageString, name,string.Join(",", values));
- }
- }
由于ASP.NET MVC在進(jìn)行參數(shù)綁定的時候會自動提取應(yīng)用在目標(biāo)參數(shù)類型或者數(shù)據(jù)成員上的ValidationAttribute特性，并利用它們對提供的數(shù)據(jù)實施驗證，所以我們不再需要像上面演示的實例一樣自行在Action方法中實施驗證，而只需要在定義參數(shù)類型Person的時候應(yīng)用相應(yīng)的ValidationAttribute特性將采用的驗證規(guī)則與對應(yīng)的數(shù)據(jù)成員相關(guān)聯(lián)。
如下所示的是屬性成員上應(yīng)用了相關(guān)ValidationAttribute特性的Person類型的定義。我們在三個屬性上均應(yīng)用了RequiredAttribute特性將它們定義成必需的數(shù)據(jù)成員，Gender和Age屬性上則分別應(yīng)用了DomainAttribute和RangeAttribute特性對有效屬性值的范圍作了相應(yīng)限制。
- public class Person
- {
- [DisplayName("姓名")]
- [Required(ErrorMessageResourceName = "Required", ErrorMessageResourceType = typeof(Resources))]
- public string Name { get; set; }
- [DisplayName("性別")]
- [Required(ErrorMessageResourceName = "Required", ErrorMessageResourceType = typeof(Resources))]
- [Domain("M", "F", "m", "f", ErrorMessageResourceName = "Domain", ErrorMessageResourceType = typeof(Resources))]
- public string Gender { get; set; }
- [DisplayName("年齡")]
- [Required(ErrorMessageResourceName = "Required", ErrorMessageResourceType = typeof(Resources))]
- [Range(18, 25, ErrorMessageResourceName = "Range", ErrorMessageResourceType = typeof(Resources))]
- public int? Age { get; set; }
- }
三個ValidationAttribute特性采用的錯誤消息均定義在項目默認(rèn)的資源文件中（我們可以采用這樣的步驟創(chuàng)建這個資源文件：右鍵選擇Solution Exploror中的項目，并在上下文菜單中選擇“屬性”選項打開“項目屬性”對象框。最后在對話框中選擇“資源”Tab頁面，通過點(diǎn)擊頁面中的鏈接創(chuàng)建一個資源文件），具體定義如圖2所示。
由于ASP.NET MVC會自動提取應(yīng)用在綁定參數(shù)類型上的ValidationAttribute特性對綁定的參數(shù)實施自動化驗證，所以我們根本不需要在具體的Action方法中來對參數(shù)作手工驗證。如下面的代碼片斷所示，我們在Action方法Index中不再顯式調(diào)用Validate方法，但是運(yùn)行該程序并在輸入不合法數(shù)據(jù)的情況下提交表單后依然會得到如圖1所示的輸出結(jié)果。
- public class HomeController : Controller
- {
- //其他成員
- [HttpPost]
- public ActionResult Index(Person person)
- {
- if (!ModelState.IsValid)
- {
- return View(person);
- }
- else
- {
- return Content("輸入數(shù)據(jù)通過驗證");
- }
- }
- }
#p#
三、讓數(shù)據(jù)類型實現(xiàn)IValidatableObject接口
除了將驗證規(guī)則通過ValidationAttribute特性直接定義在數(shù)據(jù)類型上并讓ASP.NET MVC在進(jìn)行參數(shù)綁定過程中據(jù)此來驗證參數(shù)之外，我們還可以將驗證操作直接定義在數(shù)據(jù)類型中。既然我們將驗證操作直接實現(xiàn)在了數(shù)據(jù)類型上，意味著對應(yīng)的數(shù)據(jù)對象具有“自我驗證”的能力，我們姑且將這些數(shù)據(jù)類型稱為“自我驗證類型”。這些自我驗證類型是實現(xiàn)了具有如下定義的接口IValidatableObject，該接口定義在“System.ComponentModel.DataAnnotations”命名空間下。
- public interface IValidatableObject
- {
- IEnumerable
Validate( ValidationContext validationContext); - }
如上面的代碼片斷所示，IValidatableObject接口具有唯一的方法Validate，針對自身的驗證就實現(xiàn)在該方法中。對于上面演示實例中定義的數(shù)據(jù)類型Person，我們可以按照如下的形式將它定義成自我驗證類型。
- public class Person: IValidatableObject
- {
- [DisplayName("姓名")]
- public string Name { get; set; }
- [DisplayName("性別")]
- public string Gender { get; set; }
- [DisplayName("年齡")]
- public int? Age { get; set; }
- public IEnumerable
Validate( ValidationContext validationContext) - {
- Person person = validationContext.ObjectInstance as Person;
- if (null == person)
- {
- yield break;
- }
- if(string.IsNullOrEmpty(person.Name))
- {
- yield return new ValidationResult("'Name'是必需字段", new string[]{"Name"});
- }
- if (string.IsNullOrEmpty(person.Gender))
- {
- yield return new ValidationResult("'Gender'是必需字段", new string[] { "Gender" });
- }
- else if (!new string[]{"M","F"}.Any( g=>string.Compare(person.Gender,g, true) == 0))
- {
- yield return new ValidationResult("有效'Gender'必須是'M','F'之一", new string[] { "Gender" });
- }
- if (null == person.Age)
- {
- yield return new ValidationResult("'Age'是必需字段", new string[] { "Age" });
- }
- else if (person.Age > 25 || person.Age < 18)
- {
- yield return new ValidationResult("'Age'必須在18到25周歲之間", new string[] { "Age" });
- }
- }
- }
如上面的代碼片斷所示，我們讓Person類型實現(xiàn)了IValidatableObject接口。在實現(xiàn)的Validate方法中，我們從驗證上下文中獲取被驗證的Person對象，并對其屬性成員進(jìn)行逐個驗證。如果數(shù)據(jù)成員沒有通過驗證，我們通過一個ValidationResult對象封裝錯誤消息和數(shù)據(jù)成員名稱（屬性名），該方法最終返回的是一個元素類型為ValidationResult的集合。在不對其他代碼作任何改動的情況下，我們直接運(yùn)行該程序并在輸入不合法數(shù)據(jù)的情況下提交表單后依然會得到如圖1所示的輸出結(jié)果。
四、讓數(shù)據(jù)類型實現(xiàn)IDataErrorInfo接口
上面我們讓數(shù)據(jù)類型實現(xiàn)IValidatableObject接口并將具體的驗證邏輯定義在實現(xiàn)的Validate方法中，這樣的類型能夠被ASP.NET MVC所識別，后者會自動調(diào)用該方法對綁定的數(shù)據(jù)對象實施驗證。如果我們讓數(shù)據(jù)類型實現(xiàn)IDataErrorInfo接口也能實現(xiàn)類似的自動化驗證效果。
IDataErrorInfo接口定義在“System.ComponentModel”命名空間下，它提供了一種標(biāo)準(zhǔn)的錯誤信息定制方式。如下面的代碼片段所示，IDataErrorInfo具有兩個成員，只讀屬性Error用于獲取基于自身的錯誤消息，而只讀索引用于返回指定數(shù)據(jù)成員的錯誤消息。
- public interface IDataErrorInfo
- {
- string Error { get; }
- string this[string columnName] { get; }
- }
同樣是針對上面演示的實例，現(xiàn)在我們對需要被驗證的數(shù)據(jù)類型Person進(jìn)行了重新定義。如下面的代碼片斷所示，我們讓Person實現(xiàn)了IDataErrorInfo接口。在實現(xiàn)的索引中，我們將索引參數(shù)columnName視為屬性名稱，根據(jù)它按照上面的規(guī)則對相應(yīng)的屬性成員實施驗證，并在驗證失敗的情況下返回相應(yīng)的錯誤消息。在不對其他代碼作任何改動的情況下，我們直接運(yùn)行該程序并在輸入不合法數(shù)據(jù)的情況下提交表單后依然會得到如圖1所示的輸出結(jié)果。
- public class Person : IDataErrorInfo
- {
- [DisplayName("姓名")]
- public string Name { get; set; }
- [DisplayName("性別")]
- public string Gender { get; set; }
- [DisplayName("年齡")]
- public int? Age { get; set; }
- [ScaffoldColumn(false)]
- public string Error { get; private set; }
- public string this[string columnName]
- {
- get
- {
- switch (columnName)
- {
- case "Name":
- {
- if(string.IsNullOrEmpty(this.Name))
- {
- return "'姓名'是必需字段";
- }
- return null;
- }
- case "Gender":
- {
- if (string.IsNullOrEmpty(this.Gender))
- {
- return "'性別'是必需字段";
- }
- else if (!new string[] { "M", "F" }.Any(
- g => string.Compare(this.Gender, g, true) == 0))
- {
- return "'性別'必須是'M','F'之一";
- }
- return null;
- }
- case "Age":
- {
- if (null == this.Age)
- {
- return "'年齡'是必需字段";
- }
- else if (this.Age > 25 || this.Age < 18)
- {
- return "'年齡'必須在18到25周歲之間";
- }
- return null;
- }
- default: return null;
- }
- }
- }
- }
當(dāng)前標(biāo)題：ASP.NETMVC下的四種驗證編程方式
網(wǎng)站地址：http://www.5511xx.com/article/dpoihhh.html
