C#如何实现自定义验证特性_C# ValidationAttribute自定义验证教程【进阶】

裘德小鎮的故事

裘德小鎮的故事

2026-05-09

402人浏览

原创

直接继承attribute无法触发框架验证,因为asp.net core等只识别validationattribute子类;必须继承validationattribute并重写isvalid方法,通过validationcontext.getservice获取依赖服务,且数值/日期类型需用可空类型+required或range特性。

c#如何实现自定义验证特性_c# validationattribute自定义验证教程【进阶】

为什么直接继承 Attribute 无法触发框架验证

因为 ASP.NET Core、Entity Framework 或 MVC 的验证系统只识别继承自 ValidationAttribute 的类型。你写个 RequiredAttribute : Attribute,哪怕逻辑一模一样,ModelState.IsValid 也完全无视它——框架压根不扫描非 ValidationAttribute 子类。

必须从 ValidationAttribute 派生,且重写 IsValid 方法(支持 ValidationContext 参数的重载更稳妥):

[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Parameter)]
public class NotEmptyAttribute : ValidationAttribute
{
    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        if (value == null || string.IsNullOrWhiteSpace(value.ToString()))
            return new ValidationResult(ErrorMessage ?? $"{validationContext.DisplayName} 不能为空");
        return ValidationResult.Success;
    }
}
  • ValidationContext 提供属性名、容器对象、服务容器(GetService<t>()</t>),是跨字段或查库验证的关键
  • 不要在 IsValid 里抛异常,返回 ValidationResult 才能被框架统一收集
  • 若需本地化错误消息,重写 FormatErrorMessage 方法,而非硬编码字符串

IsValid 方法里怎么安全访问依赖服务

验证逻辑需要查数据库(如用户名是否已存在)、调用外部 API(如短信验证码校验)时,不能在特性构造函数里注入服务——特性是编译期元数据,运行时才实例化,且无生命周期管理。

正确做法是在 IsValidValidationContext 中获取:

C函数速查手册(CHM版)
C函数速查手册(CHM版)

C函数速查手册(CHM版)

下载
protected override ValidationResult IsValid(object value, ValidationContext validationContext)
{
    var userService = validationContext.GetService<iuserservice>();
    if (userService == null) 
        return new ValidationResult("依赖服务未注册");

    if (userService.ExistsAsync(value.ToString()).GetAwaiter().GetResult())
        return new ValidationResult("该值已被占用", new[] { validationContext.DisplayName });

    return ValidationResult.Success;
}</iuserservice>
  • 务必判空 GetService 返回值,避免 NullReferenceException
  • 同步调用异步方法(如 GetAwaiter().GetResult())仅限验证场景,不可用于高并发接口
  • 若验证耗时明显,建议改到服务层手动校验,而非塞进 ValidationAttribute

为什么 [Required]intDateTime 总是通过

因为 [Required] 只检测值是否为 null 或空字符串,而 int 默认是 0DateTime 默认是 DateTime.MinValue,它们永远“有值”。

想让数值/日期字段真正可选,必须声明为可空类型,并加 [Required]

public class User
{
    [Required] public string Name { get; set; }     // ✅ 引用类型,有效
    [Required] public int? Age { get; set; }       // ✅ 可空值类型,有效
    [Range(1, 150)] public int Age2 { get; set; }  // ✅ 用 Range 替代 Required
    [Required] public DateTime? BirthDate { get; set; } // ✅ 可空日期
}
  • 前端传 {"age": null},JSON 反序列化后仍是 0(除非配置 JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
  • 不要试图用 [Required] 约束非空值类型,这是语义错配
  • 业务上“必须填数字”的场景,优先用 [Range] 或自定义 GreaterThan(0) 特性

自定义特性里怎么处理多语言错误提示

硬编码中文或英文字符串会卡死本地化路径。正确方式是把资源键(resource key)传进特性构造函数,再在 FormatErrorMessage 中解析:

public class EmailAttribute : ValidationAttribute
{
    public EmailAttribute() : base(nameof(Resources.EmailInvalid)) { }

    public override string FormatErrorMessage(string name)
    {
        return string.Format(CultureInfo.CurrentUICulture,
            Resources.ResourceManager.GetString(ErrorMessage, CultureInfo.CurrentUICulture),
            name);
    }
}
  • Resources 是你项目里的 .resx 资源类,确保生成操作设为 PublicResXFileCodeGenerator
  • 不要在 IsValid 里读资源,那里没有 UI 上下文,容易出错
  • 若用 ASP.NET Core 内置本地化,可通过 validationContext.GetRequiredService<istringlocalizer>()</istringlocalizer> 获取,但需确保 DI 容器已配置

最易被忽略的是:特性本身不参与 DI 生命周期,所有服务必须从 ValidationContext 动态获取,而不是构造函数注入。这点一旦搞错,整个验证链就静默失效。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

529

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

1181

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

557

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

1053

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

149

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

203

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

526

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

139

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RabbitMQ 教程手册
RabbitMQ 教程手册

共0课时 | 0人学习

Linux man-pages 项目
Linux man-pages 项目

共0课时 | 0人学习

C# 教程
C# 教程

共94课时 | 20.2万人学习