开源后端数据校验插件Validate.Net，类似Validate.js

ゝ一纸荒年。 2022-11-12 01:43 226阅读 0赞

## 介绍 ##

Validate.Net是借助Validate.js的思想开发的一套.Net服务端数据校验插件，可以更方便高效的校验实体内的属性值是否合法。内置多种常规数据校验规则（必填、字符串长度区间、字符串最大最小长度、最大最小值、值区间、Email、邮编、url、正整数、负整数、非正整数、非负整数、ip地址、qq、身份证号码、统一社会信用代码，常规密码）。支持自定义正则校验、方法重写等扩展校验。是做后端开发的必备利器。

## 软件架构 ##

.netframework4.5以上、反射、特性

![924295-20200802005623724-1618953781.png][]

## 安装教程 ##

1. 项目中引用：Validate.Net.dll（文件在目录Validate.Net\\bin\\Release\\下）;　 ![924295-20200802110104568-1679720272.png][]

[点击下载该Validate.Net.dll][Validate.Net.dll] 提取码 nloo

2. 导入命名空间：using Validate.Net;

3. gitee地址  [https://gitee.com/lkings/Validate.Net][https_gitee.com_lkings_Validate.Net]

4. 后续将支持nuget安装

## 使用说明 ##

### 实体类示例代码 ###

1 public class UserModel
      2 {
      3     /// <summary>
      4     /// 校验必填，如果添加特性[Describe]，则校验该属性不合法时
      5     /// 错误提示信息则是：属性：密码，值：xxxx， 不正确，而不是属性：Password，值：xxxx 不正确
      6     /// </summary>
      7     [ValidateRequired]
      8     [Describe("密码")]
      9     public string Password { get; set; }
     10  
     11     /// <summary>
     12     /// 校验字符串长度区间
     13     /// </summary>
     14     [ValidateRangeLength(6, 20)]
     15     [Describe("用户账户")]
     16     public string Account { get; set; }
     17  
     18     /// <summary>
     19     /// 校验字母，只能包含字母
     20     /// </summary>
     21     [ValidateLetter]
     22     public string Letter { get; set; }
     23  
     24     /// <summary>
     25     /// 校验最大值
     26     /// </summary>
     27     [ValidateMaxValue(20)]
     28     public int Age { get; set; }
     29  
     30     /// <summary>
     31     /// 校验最小值
     32     /// </summary>
     33     [ValidateMinValue(5)]
     34     public int MinLong { get; set; }
     35  
     36     /// <summary>
     37     /// 校验值区间
     38     /// </summary>
     39     [ValidateRangeValue(10,20)]
     40     public int AgeRange { get; set; }
     41  
     42     /// <summary>
     43     /// 校验最大长度
     44     /// </summary>
     45     [ValidateMaxLength(20)]
     46     public string MaxLength { get; set; }
     47  
     48     /// <summary>
     49     /// 校验最小长度
     50     /// </summary>
     51     [ValidateMinLength(5)]
     52     public string MinLength { get; set; }
     53  
     54     /// <summary>
     55     /// 校验Email
     56     /// </summary>
     57     [ValidateEmail]
     58     public string Email { get; set; }
     59  
     60     /// <summary>
     61     /// 校验邮编
     62     /// </summary>
     63     [ValidateZipCode]
     64     public string ZipCode { get; set; }
     65  
     66     /// <summary>
     67     /// 校验包含中文
     68     /// </summary>
     69     [ValidateChinese]
     70     public string Chinese { get; set; }
     71  
     72     /// <summary>
     73     /// 校验负整数
     74     /// </summary>
     75     [ValidateNegtiveInt]
     76     public int NegtiveInt { get; set; }
     77  
     78     /// <summary>
     79     /// 校验正整数
     80     /// </summary>
     81     [ValidatePositiveInt]
     82     public int PositiveInt { get; set; }
     83  
     84     /// <summary>
     85     /// 校验非负整数
     86     /// </summary>
     87     [ValidateNonnegativeInt]
     88     public double NonnegativeInt { get; set; }
     89  
     90     /// <summary>
     91     /// 校验非正整数
     92     /// </summary>
     93     [ValidateNonpositiveInt]
     94     public double NonpositiveInt { get; set; }
     95  
     96     /// <summary>
     97     /// 校验ip地址
     98     /// </summary>
     99     [ValidateIp]
    100     public string Ip { get; set; }
    101  
    102     /// <summary>
    103     /// 校验url
    104     /// </summary>
    105     [ValidateUrl]
    106     public string url { get; set; }
    107  
    108     /// <summary>
    109     /// 校验qq号
    110     /// </summary>
    111     [ValidateQQ]
    112     public string QQ { get; set; }
    113  
    114     /// <summary>
    115     /// 自定义正则校验，特性[ValidateRegular]为自定义正则表达式校验
    116     /// 第一个参数为您的正则表达式，第二个参数为自定义校验不合法时的提示信息
    117     /// </summary>
    118     [ValidateRegular("^[0-9]{6}$", "邮编格式校验失败(自定义)")]
    119     public string CustomStr { get; set; }
    120  
    121     /// <summary>
    122     /// 校验身份证（15位身份证号，和18位身份证号）
    123     /// </summary>
    124     [ValidateIDCard]
    125     public string IDCard { get; set; }
    126  
    127     /// <summary>
    128     /// 校验统一社会信用代码
    129     /// </summary>
    130     [ValidateSocialCreditCode]
    131     public string SocialCreditCode { get; set; }
    132  
    133     /// <summary>
    134     /// 一般密码校验（包含数字和字母及常规特殊符号）
    135     /// </summary>
    136     [ValidatePwd]
    137     public string Pwd { get; set; }
    138 }

### 调用示例 ###

1     static void Main(string[] args)
     2     {
     3         UserModel user = new UserModel()
     4         {
     5             Account = "1000",
     6             Password = "",
     7             Email = "77111.cn",
     8             ZipCode = "6572151",
     9             Chinese = "wjl",
    10             NegtiveInt = 1,
    11             PositiveInt= -2,
    12             Ip = "192.0.0.256",
    13             url = "https://www.baidu.com",
    14             CustomStr = "657215@",
    15             MaxLength = null,
    16             Age = 100,
    17             Letter = "www",
    18             MinLong = 0,
    19             AgeRange = 0,
    20             MinLength = "123456",
    21             QQ = "13155654521",
    22             IDCard = "2102111972110408721",
    23             SocialCreditCode = "91350500611880326T",
    24             Pwd = "wjl1345",
    25             NonpositiveInt = -66.1,
    26             NonnegativeInt = 66.1,
    27         };
    28 
    29         if (!user.Validate<UserModel>(out List<string> errorList))
    30         {
    31             foreach (string error in errorList)
    32             {
    33                 Console.WriteLine($"{error}\r\n");
    34             }
    35         }
    36         Console.ReadLine();
    37     }

### 执行结果 ###

属性：密码 - 值：  错误信息： 校验必填项失败

属性：用户账户 - 值：1000  错误信息： 长度范围为：\[6—20\]

属性：Age - 值：100  错误信息： 最大值为：20

属性：MinLong - 值：0  错误信息： 最小值为：5

属性：AgeRange - 值：0  错误信息： 值范围为：\[10—20\]

属性：Email - 值：77111.cn  错误信息： 邮箱格式校验失败

属性：ZipCode - 值：6572151  错误信息： 邮政编码格式校验失败

属性：Chinese - 值：wjl  错误信息： 中文校验失败（必须包含中文）

属性：NegtiveInt - 值：1  错误信息： 负整数校验失败

属性：PositiveInt - 值：-2  错误信息： 正整数校验失败

属性：Ip - 值：192.0.0.256  错误信息： 校验ip失败

属性：CustomStr - 值：657215@  错误信息： 邮编格式校验失败(自定义)

属性：IDCard - 值：2102111972110408721  错误信息： 校验身份证合法性失败

属性：Pwd - 值：wjl1345  错误信息：  一般密码校验失败（包含数字和字母及常规特殊符号）

## gitee地址 ##

[https://gitee.com/lkings/Validate.Net][https_gitee.com_lkings_Validate.Net]

[924295-20200802005623724-1618953781.png]: /images/20221022/507426da14b84a528acbf4db00726daf.png
[924295-20200802110104568-1679720272.png]: /images/20221022/d76c77fbd058445f80adbd25b7b03154.png
[Validate.Net.dll]: https://pan.baidu.com/s/1pxWydnjhQigX-bT6koWe5g
[https_gitee.com_lkings_Validate.Net]: https://gitee.com/lkings/Validate.Net