0

0

C#怎么自定义特性Attribute C# Attribute编程方法

幻夢星雲

幻夢星雲

发布时间:2026-01-02 11:11:02

|

716人浏览过

|

来源于php中文网

原创

自定义特性需继承Attribute类并用[AttributeUsage]指定作用目标、是否允许多次使用及是否可被继承;应用时用[]标记,运行时通过反射如GetCustomAttribute()读取。

c#怎么自定义特性attribute c# attribute编程方法

在 C# 中自定义特性(Attribute)很简单,核心是继承 System.Attribute 类,并用 [AttributeUsage] 控制其使用位置和行为。

定义自定义特性类

自定义特性本质是一个类,必须继承 Attribute,推荐加上 [AttributeUsage] 来明确它能用在哪些程序元素上(比如类、方法、属性等),并决定是否允许多次使用、是否可被子类继承。

  • AttributeTargets 枚举指定作用目标,如 ClassMethodPropertyAll
  • AllowMultiple = true 表示同一位置可以标记多个该特性
  • Inherited = false 表示子类不会自动继承父类上的该特性

例如,定义一个用于标记接口实现类的特性:

[AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = true)]
public class ImplementsInterfaceAttribute : Attribute
{
    public Type InterfaceType { get; }
    public string Version { get; set; } = "1.0";
public ImplementsInterfaceAttribute(Type interfaceType)
{
    InterfaceType = interfaceType;
}

}

在代码中应用自定义特性

直接用方括号 [] 标记在目标元素前即可。构造函数参数写在括号里,命名参数(如 Version = "2.0")放在后面。

例如:

ChatX翻译
ChatX翻译

最实用、可靠的社交类实时翻译工具。 支持全球主流的20+款社交软件的聊天应用,全球200+语言随意切换。 让您彻底告别复制粘贴的翻译模式,与世界各地高效连接!

下载
[ImplementsInterface(typeof(IRepository), Version = "2.0")]
public class UserRepository : IRepository
{
    // ...
}

运行时读取特性信息

用反射获取特性,常用方法有:

  • Attribute.GetCustomAttribute():获取单个特性(或 null)
  • Attribute.GetCustomAttributes():获取所有匹配特性的数组
  • 泛型版本如 GetCustomAttribute() 更安全简洁

例如检查某个类是否应用了该特性:

var type = typeof(UserRepository);
var attr = type.GetCustomAttribute();
if (attr != null)
{
    Console.WriteLine($"实现了接口:{attr.InterfaceType.Name},版本:{attr.Version}");
}

进阶技巧:带验证或逻辑的特性

特性本身不能直接执行逻辑,但可以配合其他机制实现效果。常见做法:

  • 在框架启动/注册阶段扫描类型,根据特性自动注册服务(如 ASP.NET Core 的 DI 或 MediatR)
  • 结合 Source Generator 在编译期生成代码(C# 9+)
  • 配合 AOP 框架(如 AspectCore、Fody)在方法调用前后注入行为

注意:不要在特性类中放复杂逻辑或副作用代码——它只是**元数据容器**,运行时才由你主动读取并响应。

基本上就这些。自定义特性不复杂,但容易忽略 AttributeUsage 的设置和反射读取时机,用对了能极大提升代码表达力和框架扩展性。

相关文章

编程速学教程(入门课程)
编程速学教程(入门课程)

编程怎么学习?编程怎么入门?编程在哪学?编程怎么学才快?不用担心,这里为大家提供了编程速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

229

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

434

2024.03.01

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

229

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

434

2024.03.01

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

229

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

434

2024.03.01

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

992

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

51

2025.10.17

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

74

2025.12.31

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 5.8万人学习

C 教程
C 教程

共75课时 | 3.8万人学习

C++教程
C++教程

共115课时 | 10.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号