C#的特性(Attribute)是什么?如何创建和使用自定义特性?

星降
发布: 2025-11-23 18:52:02
原创
602人浏览过
自定义特性通过继承System.Attribute创建,使用AttributeUsage指定应用目标,如[AttributeUsage(AttributeTargets.Method)]public class LogActionAttribute : Attribute{ public string ActionName { get; set; } public LogActionAttribute(string actionName) { ActionName = actionName; }},然后可将[LogAction("用户登录", ActionName = "Authentication")]应用于方法,并通过反射在运行时读取特性数据,实现声明式编程,常用于日志、权限、序列化等场景。

c#的特性(attribute)是什么?如何创建和使用自定义特性?

特性(Attribute)是 C# 中一种为代码元素添加元数据的机制。它允许你在类、方法、属性、参数等程序元素上附加声明性信息,这些信息可以在编译时或运行时通过反射读取和处理。

例如,内置特性 [Obsolete] 可以标记某个方法已过时,编译器会给出警告:

[Obsolete("此方法已废弃,请使用 NewMethod")] void OldMethod() { }

如何创建自定义特性?

自定义特性是一个继承自 System.Attribute 的类。通常命名以 "Attribute" 结尾,但在使用时可以省略该后缀。

下面是一个简单的自定义特性的定义:

[AttributeUsage(AttributeTargets.Method)] // 限制只能用于方法 public class LogActionAttribute : Attribute { public string ActionName { get; set; }
public LogActionAttribute(string actionName)
{
    ActionName = actionName;
}
登录后复制

}

说明:

  • AttributeUsage 指定该特性可应用的目标(如类、方法、属性等)。
  • 构造函数用于在使用特性时传入必要参数。
  • 公共属性可用于传递额外的命名参数。

如何使用自定义特性?

定义好特性后,就可以将其应用到目标代码元素上。

ChatsNow
ChatsNow

ChatsNow是一款免费的AI写作类浏览器插件,提供智能聊天机器人、智能翻译、智能搜索等工具

ChatsNow 253
查看详情 ChatsNow

class Program { [LogAction("用户登录", ActionName = "Authentication")] public static void Login() { Console.WriteLine("执行登录操作"); } }

上面代码中,[LogAction("用户登录")] 将特性附加到 Login 方法上,其中 "用户登录" 是构造函数参数,ActionName 是命名参数。

如何在运行时读取特性?

通过反射可以检查某个方法是否被特定特性标记,并获取其数据。

static void Main() { var method = typeof(Program).GetMethod("Login"); var attribute = method.GetCustomAttribute();

if (attribute != null)
{
    Console.WriteLine($"动作描述: {attribute.ActionName}");
}

// 执行方法
Login();
登录后复制

}

输出结果:

动作描述: Authentication 执行登录操作

这种机制常用于日志记录、权限验证、序列化控制、API 文档生成等场景。

基本上就这些。自定义特性不复杂但容易忽略细节,比如作用目标和是否允许多次使用(AllowMultiple),记得用 AttributeUsage 明确约束。

以上就是C#的特性(Attribute)是什么?如何创建和使用自定义特性?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

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