C# 如何自定义特性(Attribute) - 元数据编程的强大功能-C#.Net教程-PHP中文网

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

煙雲

发布： 2025-12-23 10:39:08

原创

161人浏览过

自定义特性是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，否则编译报错
特性不会影响编译结果或运行行为——除非你主动用反射去读它