0

0

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

星降

星降

发布时间:2025-11-23 18:52:02

|

675人浏览过

|

来源于php中文网

原创

自定义特性通过继承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 指定该特性可应用的目标(如类、方法、属性等)。
  • 构造函数用于在使用特性时传入必要参数。
  • 公共属性可用于传递额外的命名参数。

如何使用自定义特性?

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

FashionLabs
FashionLabs

AI服装模特、商品图,可商用,低价提升销量神器

下载

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 明确约束。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

174

2023.11.23

java中void的含义
java中void的含义

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

95

2025.11.27

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

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

463

2024.01.03

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

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

12

2025.12.06

attributeusage
attributeusage

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

245

2023.07.13

console接口是干嘛的
console接口是干嘛的

console接口是一种用于在计算机命令行或浏览器开发工具中输出信息的工具,提供了一种简单的方式来记录和查看应用程序的输出结果和调试信息。本专题为大家提供console接口相关的各种文章、以及下载和课程。

411

2023.08.08

console.log是什么
console.log是什么

console.log 是 javascript 函数,用于在浏览器控制台中输出信息,便于调试和故障排除。想了解更多console.log的相关内容,可以阅读本专题下面的文章。

484

2024.05.29

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

3

2026.01.09

热门下载

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

精品课程

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

共94课时 | 6.4万人学习

C 教程
C 教程

共75课时 | 4万人学习

C++教程
C++教程

共115课时 | 11.7万人学习

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

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