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";
<pre class="brush:php;toolbar:false;">public ImplementsInterfaceAttribute(Type interfaceType)
{
    InterfaceType = interfaceType;
}

}

在代码中应用自定义特性

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

例如:

Magic AI Avatars
Magic AI Avatars

神奇的AI头像,获得200多个由AI制作的自定义头像。

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

运行时读取特性信息

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

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

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

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

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

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

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

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

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

254

2023.09.22

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

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

1089

2024.03.01

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

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

254

2023.09.22

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

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

1089

2024.03.01

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

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

254

2023.09.22

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

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

1089

2024.03.01

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

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

1926

2023.10.19

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

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

656

2025.10.17

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

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

76

2026.03.11

热门下载

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

精品课程

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

共94课时 | 11.2万人学习

C 教程
C 教程

共75课时 | 5.4万人学习

C++教程
C++教程

共115课时 | 21.6万人学习

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

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