0

0

C# 如何自定义特性(Attribute) - 元数据编程的强大功能

煙雲

煙雲

发布时间:2025-12-23 10:39:08

|

181人浏览过

|

来源于php中文网

原创

自定义特性是C#中继承Attribute类、用AttributeUsage声明使用范围的元数据机制,通过构造函数参数(位置参数)和属性(命名参数)传递配置,需反射读取并谨慎用于解耦配置与行为。

c# 如何自定义特性(attribute) - 元数据编程的强大功能

自定义特性(Attribute)是 C# 中实现元数据编程的核心机制,它让你能在代码中声明式地附加额外信息,并在运行时通过反射读取和使用这些信息。关键不在于“加标签”,而在于“让标签可被识别、可被提取、可被逻辑驱动”。

定义一个自定义特性类

自定义特性本质是一个继承自 Attribute 的类。它支持构造函数参数和命名参数(属性),但必须显式标记 [AttributeUsage] 来说明它能用在哪些程序元素上(如类、方法、属性等)。

  • [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)] 控制使用范围、是否允许多次使用、是否继承
  • 构造函数参数对应“位置参数”,用于必填信息;public set 访问器的属性对应“命名参数”,用于可选配置
  • 避免在特性中放复杂逻辑或副作用——它只是数据容器,不是执行单元

在代码中应用自定义特性

语法和内置特性一样,写在目标元素上方,括号内传入参数即可。支持位置参数(按构造函数顺序)、命名参数(PropertyName = value),也可混合使用。

  • 例如:[ApiVersion(2, Description = "v2 接口", IsDeprecated = true)] public class UserController { ... }
  • 多个同类型特性需开启 AllowMultiple = true,否则编译报错
  • 特性不会影响编译结果或运行行为——除非你主动用反射去读它

在运行时读取并使用特性信息

靠反射(Reflection)获取:调用 GetCustomAttribute()GetCustomAttributes() 方法,从类型、方法、属性等成员对象上提取实例。

先见AI
先见AI

数据为基,先见未见

下载
  • 推荐优先用泛型版本,类型安全且性能更好;非泛型版返回 object[],需手动转换
  • 常用于框架扩展场景:比如 Web API 根据 [Route] 生成路由,或 ORM 框架根据 [Column] 映射数据库字段
  • 注意:反射有性能开销,建议缓存读取结果(如用 ConcurrentDictionary 存储解析后的元数据)

进阶技巧:结合特性与接口/工厂提升可维护性

单纯读特性容易让逻辑散落在各处。更清晰的做法是让特性关联行为——比如定义一个接口 IActionFilter,再让特性实现它,或通过工厂根据特性类型创建处理器

  • 例如:定义 [LogExecution] 特性,再配合 AOP 框架(如 AspectCore)自动注入日志逻辑
  • 或在中间件中扫描所有标记了 [RequiresPermission("Admin")] 的控制器方法,统一做权限拦截
  • 特性本身不执行,但它是触发执行的“开关”和“配置源”

基本上就这些。自定义特性不是炫技工具,而是把“配置”和“行为”解耦的关键一环——写得清楚,读得准确,用得克制,它就能成为你架构里安静又可靠的元数据引擎。

相关文章

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

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

下载

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

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

177

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

212

2025.12.18

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

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

1018

2023.10.19

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

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

62

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

400

2025.12.29

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

464

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

12

2025.12.06

attributeusage
attributeusage

attributeusage是是C#中用于指定自定义属性的有效目标的类。通过使用AttributeUsage,可以控制自定义属性在何处可以应用,以便更好地管理和利用元数据,有助于提高代码的可读性和可维护性,使开发人员能够更好地理解和使用代码中的属性。本专题为大家提供attributeusage相关的各种文章、以及下载和课程。

245

2023.07.13

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

0

2026.01.15

热门下载

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

精品课程

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

共48课时 | 7.2万人学习

Django 教程
Django 教程

共28课时 | 3.1万人学习

NumPy 教程
NumPy 教程

共44课时 | 2.9万人学习

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

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