ASP.NET Web Forms如何避免前后端验证重复？跨项目复用验证方案

我太懂这种两边维护验证逻辑的痛苦了——重复劳动不说，还容易出现规则不一致的坑。刚好我之前处理过类似场景，给你几个可行的方案，能让你在两个项目里复用同一套验证规则，不用再分别维护：

方案1：共享类库+标准DataAnnotations（最易上手） #

核心思路是把带验证注解的模型放到一个独立类库，两个项目都引用它，然后给Web Forms做适配（毕竟MVC原生就支持DataAnnotations）。

步骤1：创建共享模型类库 #

新建一个类库项目，把所有需要验证的实体放在这里，用标准的System.ComponentModel.DataAnnotations注解：

using System.ComponentModel.DataAnnotations;

namespace SharedValidationModels
{
    public class UserModel
    {
        [Required(ErrorMessage = "用户名不能为空")]
        [StringLength(20, MinimumLength = 3, ErrorMessage = "用户名长度需在3-20字符之间")]
        public string Username { get; set; }

        [Required(ErrorMessage = "邮箱不能为空")]
        [EmailAddress(ErrorMessage = "请输入有效的邮箱格式")]
        public string Email { get; set; }
    }
}

步骤2：MVC项目直接使用 #

MVC原生支持DataAnnotations的服务器端+客户端验证，直接在Controller和View里用就行，完全不用额外配置：

// MVC Controller
[HttpPost]
public ActionResult Register(UserModel model)
{
    if(ModelState.IsValid)
    {
        // 处理注册逻辑
        return RedirectToAction("Success");
    }
    return View(model);
}

步骤3：Web Forms项目适配验证 #

Web Forms默认不自动识别DataAnnotations，需要手动实现服务器端+客户端验证：

服务器端验证（代码后置）

在按钮点击事件里用Validator.TryValidateObject验证模型：

using SharedValidationModels;
using System.ComponentModel.DataAnnotations;
using System.Collections.Generic;

protected void btnSubmit_Click(object sender, EventArgs e)
{
    var user = new UserModel
    {
        Username = txtUsername.Text,
        Email = txtEmail.Text
    };

    var validationResults = new List<ValidationResult>();
    var validationContext = new ValidationContext(user, null, null);
    
    if (!Validator.TryValidateObject(user, validationContext, validationResults, validateAllProperties: true))
    {
        // 把错误信息绑定到ValidationSummary
        ValidationSummary1.ShowSummary = true;
        foreach (var result in validationResults)
        {
            ValidationSummary1.ErrorMessage += $"{result.ErrorMessage}<br/>";
        }
    }
    else
    {
        // 验证通过，跳转或处理逻辑
        Response.Redirect("Success.aspx");
    }
}

客户端验证（复用注解规则）

如果需要客户端验证，可通过后台生成验证规则JSON，前端用JS实现：

// Web Forms Page_Load生成验证规则
protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        var metadata = ModelMetadataProviders.Current.GetMetadataForType(null, typeof(UserModel));
        var validationRules = new Dictionary<string, List<object>>();

        foreach (var property in metadata.Properties)
        {
            var rules = new List<object>();
            foreach (var attr in property.GetValidators(null))
            {
                if (attr is RequiredAttributeAdapter requiredAttr)
                {
                    rules.Add(new { type = "required", message = requiredAttr.Attribute.ErrorMessage });
                }
                else if (attr is StringLengthAttributeAdapter lengthAttr)
                {
                    rules.Add(new { type = "stringLength", min = lengthAttr.Attribute.MinimumLength, max = lengthAttr.Attribute.MaximumLength, message = lengthAttr.Attribute.ErrorMessage });
                }
                // 其他注解（如EmailAddress）同理添加
            }
            validationRules[property.PropertyName] = rules;
        }

        // 把规则转成JSON传给前端
        var jsonRules = Newtonsoft.Json.JsonConvert.SerializeObject(validationRules);
        ClientScript.RegisterStartupScript(this.GetType(), "validationRules", $"var validationRules = {jsonRules};", true);
    }
}

前端JS验证函数：

function validateForm() {
    let isValid = true;
    const errors = [];
    const username = document.getElementById('txtUsername').value.trim();
    
    // 验证用户名
    const usernameRules = validationRules.Username;
    usernameRules.forEach(rule => {
        if (rule.type === 'required' && !username) {
            errors.push(rule.message);
            isValid = false;
        }
        if (rule.type === 'stringLength' && (username.length < rule.min || username.length > rule.max)) {
            errors.push(rule.message);
            isValid = false;
        }
    });

    // 验证邮箱逻辑同理...

    if (!isValid) {
        document.getElementById('ValidationSummary1').innerHTML = errors.join('<br/>');
        document.getElementById('ValidationSummary1').style.display = 'block';
        return false;
    }
    return true;
}

最后给提交按钮加OnClientClick="return validateForm();"即可。

方案2：用FluentValidation替代DataAnnotations（更灵活） #

如果你的验证规则比较复杂，FluentValidation比DataAnnotations更灵活，而且对Web Forms和MVC都有良好支持：

步骤1：共享类库写验证器 #

using FluentValidation;

namespace SharedValidationModels
{
    public class UserModelValidator : AbstractValidator<UserModel>
    {
        public UserModelValidator()
        {
            RuleFor(x => x.Username)
                .NotEmpty().WithMessage("用户名不能为空")
                .Length(3, 20).WithMessage("用户名长度需在3-20字符之间");

            RuleFor(x => x.Email)
                .NotEmpty().WithMessage("邮箱不能为空")
                .EmailAddress().WithMessage("请输入有效的邮箱格式");
        }
    }
}

步骤2：MVC项目集成 #

安装FluentValidation.Mvc5包后，自动支持服务器端+客户端验证，无需额外代码。

步骤3：Web Forms项目验证 #

服务器端直接用验证器：

protected void btnSubmit_Click(object sender, EventArgs e)
{
    var user = new UserModel
    {
        Username = txtUsername.Text,
        Email = txtEmail.Text
    };

    var validator = new UserModelValidator();
    var result = validator.Validate(user);

    if (!result.IsValid)
    {
        ValidationSummary1.ShowSummary = true;
        foreach (var error in result.Errors)
        {
            ValidationSummary1.ErrorMessage += $"{error.ErrorMessage}<br/>";
        }
    }
    else
    {
        // 处理逻辑
    }
}

客户端验证可通过FluentValidation的JS生成工具，把验证规则转换成前端可用的JS代码，思路和方案1类似。

方案3：自定义Web Forms验证控件（更原生） #

如果你希望Web Forms用起来和原生验证控件一样方便，可以自定义一个继承BaseValidator的控件，自动读取模型的DataAnnotations：

using System;
using System.ComponentModel.DataAnnotations;
using System.Reflection;
using System.Web.UI.WebControls;

public class DataAnnotationValidator : BaseValidator
{
    public Type ModelType { get; set; }
    public string PropertyName { get; set; }

    protected override bool EvaluateIsValid()
    {
        var model = Activator.CreateInstance(ModelType);
        var property = ModelType.GetProperty(PropertyName);
        property.SetValue(model, GetControlValidationValue(ControlToValidate));

        var validationResults = new List<ValidationResult>();
        var validationContext = new ValidationContext(model, null, null) { MemberName = PropertyName };

        return Validator.TryValidateProperty(property.GetValue(model), validationContext, validationResults);
    }

    protected override void AddAttributesToRender(HtmlTextWriter writer)
    {
        base.AddAttributesToRender(writer);
        var property = ModelType.GetProperty(PropertyName);
        var attrs = property.GetCustomAttributes(typeof(ValidationAttribute), true).Cast<ValidationAttribute>();

        foreach (var attr in attrs)
        {
            if (attr is RequiredAttribute)
            {
                writer.AddAttribute("data-val", "true");
                writer.AddAttribute("data-val-required", attr.ErrorMessage);
            }
            // 其他注解同理添加属性
        }
    }
}

页面中使用：

<asp:TextBox ID="txtUsername" runat="server"></asp:TextBox>
<custom:DataAnnotationValidator ID="valUsername" runat="server" 
    ControlToValidate="txtUsername" 
    ModelType="SharedValidationModels.UserModel" 
    PropertyName="Username"
    ErrorMessage="用户名验证失败"></custom:DataAnnotationValidator>

再引入MVC常用的jQuery Validation和jQuery Unobtrusive Validation，就能自动实现客户端验证。

内容的提问来源于stack exchange，提问作者itay312