ASP.NET Core中的模型验证是什么？如何实现？-C#.Net教程-PHP中文网

ASP.NET Core中的模型验证是什么？如何实现？

幻夢星雲

发布： 2025-09-12 08:30:03

原创

228人浏览过

答案：ASP.NET Core模型验证通过数据注解、自定义验证属性、IValidatableObject接口和远程验证实现，结合ModelState.IsValid在控制器中验证数据，并在API中返回BadRequest(ModelState)以提供错误详情，同时支持客户端验证以提升用户体验。

asp.net core中的模型验证是什么？如何实现？

ASP.NET Core中的模型验证，简单来说，就是确保你从客户端（比如浏览器）接收到的数据符合你预期的格式和规则。这对于保证数据的完整性、安全性和应用程序的稳定运行至关重要。实现方式多种多样，但核心都是围绕着数据注解（Data Annotations）和自定义验证展开的。

解决方案：

ASP.NET Core提供了强大的模型验证机制，主要通过以下几个步骤实现：

数据注解（Data Annotations）： 这是最常用的方式。你可以在你的模型类（通常是ViewModel或DTO）的属性上添加各种注解，例如

[Required]

登录后复制

、

[StringLength]

登录后复制

、

[Range]

登录后复制

、

[EmailAddress]

登录后复制

等。这些注解定义了属性必须满足的规则。

public class UserViewModel
{
    [Required(ErrorMessage = "用户名是必填项")]
    [StringLength(50, MinimumLength = 3, ErrorMessage = "用户名长度必须在3到50个字符之间")]
    public string Username { get; set; }

    [Required(ErrorMessage = "密码是必填项")]
    [DataType(DataType.Password)]
    public string Password { get; set; }

    [EmailAddress(ErrorMessage = "无效的邮箱地址")]
    public string Email { get; set; }

    [Range(18, 120, ErrorMessage = "年龄必须在18到120之间")]
    public int Age { get; set; }
}

登录后复制

在Controller中使用

ModelState.IsValid

登录后复制

进行验证： 当你的Controller接收到模型数据时，你需要检查

ModelState.IsValid

登录后复制

属性。如果该属性为

false

登录后复制

，则表示模型验证失败，你需要将错误信息返回给客户端。

[HttpPost]
public IActionResult Create(UserViewModel model)
{
    if (!ModelState.IsValid)
    {
        // 模型验证失败，将错误信息返回给客户端
        return View(model); // 或者返回BadRequest，根据你的API设计
    }

    // 模型验证成功，执行后续操作（例如保存到数据库）
    // ...

    return RedirectToAction("Index");
}

登录后复制

自定义验证属性： 如果数据注解无法满足你的需求，你可以创建自定义的验证属性。这需要你继承

ValidationAttribute

登录后复制

类，并重写

IsValid

登录后复制

方法。

public class CustomValidationAttribute : ValidationAttribute
{
    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        if (value == null)
        {
            return new ValidationResult("值不能为空");
        }

        string strValue = value.ToString();
        if (strValue.Contains("forbiddenWord"))
        {
            return new ValidationResult("值包含禁用词");
        }

        return ValidationResult.Success;
    }
}

public class MyModel
{
    [CustomValidation]
    public string MyProperty { get; set; }
}

登录后复制

IValidatableObject

登录后复制

接口： 模型类也可以实现

IValidatableObject

登录后复制

接口，该接口包含一个

Validate

登录后复制

方法，你可以在该方法中执行更复杂的验证逻辑，例如跨属性验证。

public class Product : IValidatableObject
{
    public decimal Price { get; set; }
    public decimal Discount { get; set; }

    public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
    {
        if (Discount > Price)
        {
            yield return new ValidationResult("折扣不能大于价格", new[] { "Discount", "Price" });
        }
    }
}

登录后复制

客户端验证： ASP.NET Core 默认支持客户端验证，这意味着验证规则会在客户端（通常是浏览器）执行，从而减少服务器的负载。客户端验证依赖于jQuery Validate插件。

为什么我的模型验证总是失败？

模型验证失败的原因有很多，最常见的是：

必填字段为空： 使用了
```
[Required]
```
登录后复制
注解的字段没有提供值。
数据类型不匹配： 例如，你期望一个整数，但客户端发送的是字符串。
超出范围： 使用了
```
[Range]
```
登录后复制
注解的字段的值超出了指定的范围。
字符串长度不符合要求： 使用了
```
[StringLength]
```
登录后复制
注解的字段的长度不符合要求。
邮箱地址格式不正确： 使用了
```
[EmailAddress]
```
登录后复制
注解的字段不是有效的邮箱地址。
自定义验证失败： 你的自定义验证属性返回了错误。
客户端验证未启用或配置错误： 客户端验证依赖于一些javascript库，如果这些库没有正确引入或者配置，客户端验证将不会生效。

为了诊断问题，你可以：

百度文心百中

百度大模型语义搜索体验中心

查看详情

在
```
ModelState.IsValid
```
登录后复制
为
```
false
```
登录后复制
时，遍历
```
ModelState.Values
```
登录后复制
，查看每个属性的错误信息。
使用浏览器的开发者工具查看客户端发送的数据是否正确。
调试你的自定义验证属性，确保其逻辑正确。

如何在API中使用模型验证？

在API中使用模型验证与在MVC应用程序中使用模型验证类似，但返回结果的方式略有不同。通常，API会返回一个包含错误信息的JSON响应，而不是一个View。

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] UserViewModel model)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState); // 返回400 Bad Request，包含错误信息
        }

        // ...
        return CreatedAtAction(nameof(Get), new { id = 1 }, model); // 返回201 Created
    }

    [HttpGet("{id}")]
    public IActionResult Get(int id)
    {
        return Ok(new { Id = id, Name = "Test" });
    }
}

登录后复制

在这个例子中，如果模型验证失败，

BadRequest(ModelState)

登录后复制

会返回一个400 Bad Request响应，响应体包含一个JSON对象，其中包含了所有验证错误信息。客户端可以解析这个JSON对象，并将错误信息显示给用户。

[FromBody]

登录后复制

特性告诉 ASP.NET Core 从请求正文中读取数据并将其绑定到

UserViewModel

登录后复制

模型。

如何禁用客户端验证？

虽然客户端验证可以提高用户体验，但在某些情况下，你可能需要禁用它。例如，你可能需要使用自定义的客户端验证逻辑，或者你可能不希望在客户端暴露验证规则。

你可以通过以下方式禁用客户端验证：

在
_ViewStart.cshtml
登录后复制
中禁用：你可以设置
```
ViewData["ValidateAntiForgeryToken"] = false;
```
登录后复制
来禁用整个应用程序的客户端验证。
在特定的View中禁用： 你可以在特定的View中设置
```
ViewData["ValidateAntiForgeryToken"] = false;
```
登录后复制
来禁用该View的客户端验证。
在Controller Action中禁用： 你可以在Controller Action中使用
```
[IgnoreAntiforgeryToken]
```
登录后复制
特性来禁用该Action的客户端验证。

需要注意的是，禁用客户端验证会增加服务器的负载，因为所有验证都需要在服务器端执行。另外，

ValidateAntiForgeryToken

登录后复制

用于防止跨站点请求伪造（CSRF）攻击。禁用它通常是不推荐的，除非你有其他的CSRF保护机制。

如何进行远程验证？

远程验证允许你使用服务器端的代码来验证客户端输入。这对于需要访问数据库或其他外部资源的验证非常有用。例如，你可以使用远程验证来检查用户名是否已存在。

创建Controller Action： 你需要创建一个Controller Action来执行验证逻辑。该Action应该返回一个JSON对象，其中包含一个布尔值，表示验证是否成功。

[AcceptVerbs("Get", "Post")]
public IActionResult VerifyUsername(string username)
{
    if (_userService.IsUsernameAvailable(username))
    {
        return Json(true); // 用户名可用
    }
    else
    {
        return Json($"用户名 {username} 已经被使用"); // 用户名不可用
    }
}

登录后复制

使用

[Remote]

登录后复制

注解： 在你的模型类的属性上使用

[Remote]

登录后复制

注解，指定用于执行验证的Controller Action。

public class UserViewModel
{
    [Remote(action: "VerifyUsername", controller: "Users")]
    [Required(ErrorMessage = "用户名是必填项")]
    public string Username { get; set; }
}

登录后复制