浅谈在ASP.NET MVC3中使用IClientValidatable接口实现客户端和服务器端同时验证

时间：2022-12-08 14:46:00
例如：Range、RegularExpression、Required、StringLength等验证属性，这些属性极大的方便了服务器端的验证，同时我们还可以自定义验证属性来满足我们特殊的需求，MVC3的出现进一步提升了验证的便捷性，具体体现在，新增了IValidatableObject和IClientValidatable接口，以及默认支持Range、RegularExpression、Required、StringLength等验证属性在客户端和服务器端进行验证。

IValidatableObject接口，网上已经有很多的资料了，今天我主要介绍IClientValidatable这个接口，IClientValidatable 接口允许 ASP.NET MVC 在运行时发现支持的客户端验证器，这个接口被用来支持集成不同的验证框架——摘自：ASP.NET MVC3概述。

下面我们就来看看如何使用IClientValidatable接口来实现客户端和服务器端的验证。

首先我们来自定义一个验证属性NoIsAttribute.cs，该属性的主要作用是验证用户名中不能含有指定的字符串，代码如下：

public sealed class NoIsAttribute:ValidationAttribute
    {
        public string InputString { get; set; }
        public NoIsAttribute()
        {
            ErrorMessage = "验证失败";
        }

        public override bool IsValid(object value)
        {
            if (value == null)
                return true;
            string inputString = (string)value;
            if (inputString.Contains(InputString))
            {
                return false;
            }
            return true;
        }
    }


下面我们来创建一个实体类Logon.cs

public class Logon
    {
        [DisplayName("年龄")]
        [Range(6,100)]
        public int Age { get; set; }

        [DisplayName("姓名")]
        [NoIs(InputString="卜俊生",ErrorMessage="用户名不能含有卜俊生")]
        public string Name { get; set; }

    }


在Logon.cs中我们对Name属性应用了Nois验证属性，这样用户在登录过程中如果输入了包含“卜俊生”，那么将无法通过验证，不过该属性只能当用户将数据提交到服务器后才能对数据进行验证，（其中Age属性应用了Range验证属性，因为asp.net mvc3默认支持对range进行客户端验证，所以当用户输入年龄后，如果年龄不符合要求则在客户端进行验证。），为了让NoIs验证属性也能在客户端进行验证，我们就需要将NoIsAttribute.cs实现IClientValidatable接口，所以我们要改造我们的NoIsAttribute.cs代码。

public sealed class NoIsAttribute:ValidationAttribute,IClientValidatable
    {
        public string InputString { get; set; }
        public NoIsAttribute()
        {
            ErrorMessage = "验证失败";
        }
        public IEnumerable<ModelClientValidationRule> GetClientValidationRules(ModelMetadata metadata, ControllerContext context)
        {
            ModelClientValidationRule rule = new ModelClientValidationRule
            {
                ValidationType = "nois",
                ErrorMessage = FormatErrorMessage(metadata.GetDisplayName())
            };
            rule.ValidationParameters["inputstring"] = InputString;
            yield return rule;
        }

        public override bool IsValid(object value)
        {
            if (value == null)
                return true;
            string inputString = (string)value;
            if (inputString.Contains(InputString))
            {
                return false;
            }
            return true;
        }
    }

IClientValidatable 接口很简单，他只有一个GetClientValidationRules（）方法，我们只要实现这个方法就可以了，这个方法包括两个参数，metadata表示要验证的属性的元数据，context表示发送请求的Controller的上下文，并且它返回一个ModelClientValidationRule集合。

我们先来看看这段代码：

ModelClientValidationRule rule = new ModelClientValidationRule
            {
                ValidationType = "nois",
                ErrorMessage = FormatErrorMessage(metadata.GetDisplayName())
            };

这段代码是创建一个ModelClientValidationRule对象，并且为其两个属性赋值，其中ValidationType是验证类型（客户端代码需要调用该属性），ErrorMessage是错误信息。

让后我们再来看看下面这句代码：

rule.ValidationParameters["inputstring"] = InputString;

这句代码的意思是添加一个验证属性”inputstring”，它的值是InputString,需要注意的是ValidationParameters是一个IDictionary<string,object>字典，最重要的是ValidationParameters的key必须是小写的，不能包含任何大写字母，否则运行时会报错，请一定要谨记。

IClientValidatable.cs完成后，我们还需要编写客户端代码才能实现客户端和服务器端同时验证。

默认情况下asp.net mvc3已经开启了客户端验证和隐藏验证，这一点我们可以在web.config中查看

 

<appSettings>
    <add key="ClientValidationEnabled" value="true"/> 
    <add key="UnobtrusiveJavaScriptEnabled" value="true"/> 
  </appSettings>


那么默认情况下asp.net mvc3使用jquery的Validate插件进行客户端验证，所以你会在View文件中看见图下代码

 

<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>


下面我们就要为validate插件编写自定义验证规则，并将规则添加到unobtrusive中，代码如下：

 

<script type="text/javascript">
    $.validator.addMethod("nois", function (value, element, param) {
        if (value == false) {
            return true;
        }
        if (value.indexOf(param) != -1) {
            return false;
        }
        else {
            return true;
        }

    });
    $.validator.unobtrusive.adapters.addSingleVal("nois","inputstring");
</script>



如要注意的是addMethod这个函数的第一个参数值必须和IClientValidatable.cs中的ValidationType的值必须一致，都必须是”nois”，还有就是 $.validator.unobtrusive.adapters.addSingleVal("nois","inputstring"); 这一句中的第二个参数值要和ValidationParameters的key的值相同，必须是“inputstring“。

这样就可实现客户端和服务器端同时验证了，有兴趣的朋友可以试下。

标签：

相关文章