总结一下 C# 如何自定义特性 Attribute 并进行应用

前言

Attribute(特性)是一种用于为程序元素(如类、方法、属性等)提供元数据信息的方法。

特性是一种声明式的信息,附加到程序元素上,提供额外的数据用于描述和控制这些元素的行为。

在编译和运行时,都可以读取特性提供的信息对程序元素进行分析和操作。

特性通常用于实现以下功能:

  1. 为代码添加元数据信息:特性为元素(类、方法、属性等)添加额外的元数据信息,描述其用途、状态、约束等。

  2. 控制编译行为:特性可以用于控制编译器对代码的处理,如指示编译器生成额外的代码、忽略特定警告等。

  3. 在运行时进行反射操作:特性可以在运行时通过反射获取并读取,用于实现一些动态的行为,如配置加载、权限检查等。

C# 本身提供了一些常用的特性,如 SerializableObsoleteConditional 等,同时我们也可以自定义特性来满足特定的需求。

特性的应用范围非常广泛,在实际开发中经常用于标记和控制程序的行为,提高代码的可读性和灵活性。

下面看看如何自定义特性 Attribute 并进行应用。

Step By Step 步骤:

  1. 创建一个 ASP.NET Core Web Api 项目

  2. 创建一个 Attribute

    c# 复制代码
    namespace AttributeSample
    {
    	// 说明此特性应用在属性上
    	[AttributeUsage(AttributeTargets.Property)]
    	public class TestAttribute: Attribute
    	{
    		public string DisplayName { get; set; }
    	 
    		public int DisplayWidth { get; set; }
    
    		public TestAttribute(string displayName, int displayWidth)
    		{
    			DisplayName = displayName;
    			DisplayWidth = displayWidth;
    		}
    	}
    }
  3. 创建一个类,应用这个 Attribute

    c# 复制代码
    public class Points
    {
        [Test("站点名称", 100)]
        public string StationNo { get; set; }
    
        [Test("P1数据名称", 100)]
        public float TD_P1 { get; set; }
    
        [Test("P2数据名称", 100)]
        public float TD_P2 { get; set; }
    }
  4. 在控制器中读取 Points 类的属性的特性的值并应用

    c# 复制代码
    namespace AttributeSample.Controllers
    {
    	[ApiController]
    	[Route("[controller]")]
    	public class WeatherForecastController : ControllerBase
    	{
    		private readonly ILogger<WeatherForecastController> _logger;
    
    		public WeatherForecastController(ILogger<WeatherForecastController> logger)
    		{
    			_logger = logger;
    
    			// 获取 Attribute 内容
    			Type t = typeof(Points);
    			foreach (PropertyInfo pi in t.GetProperties())
    			{
    				string propertyName = pi.Name;
    				string displayName = pi.GetCustomAttribute<TestAttribute>()?.DisplayName!;
    				int displayWidth = pi.GetCustomAttribute<TestAttribute>().DisplayWidth;
    				
    				// 读取类属性的特性值之后,可以进行一些操作,这里是打印出来
    				_logger.LogInformation("属性名称:" + propertyName + ";显示名称:" + displayName + ";显示宽度:" + displayWidth);
    			}
    		}
    		......
    	}

总结

  1. Attrbiute 本身只是 "标签",脱离了通过反射操作它的代码逻辑,它什么也不是
  2. Attribute 本身,就是个标记,没什么功能。但是,别的工具、框架(比如上面的控制器)在做事的时候,会看相关的 Attribute,做相应的处理。这是最主要的作用
  3. 总的来说就是可以用 Attribute 给代码元素(类,方法,成员变量,属性 等等)打个标签,附加一些信息,在调用这些代码的时候利用反射取出这些信息并根据这些信息做些不同的事情
  4. Attribute 一定是配合反射使用的。也就说,你看不到的外层框架性代码一定有调用反射去寻找这些 Attribute。
  5. 可以利用 Attribute 更好地解耦业务,更好地符合单一职责原则,比如一个方法要实现三个业务场景,保存数据之后要发送一个邮件和发送一个消息,就可以在方法中只做保存数据的业务场景,利用 Attribute 来实现发送邮件和消息的业务场景。

我是老杨,一个奋斗在一线的资深研发老鸟,让我们一起聊聊技术,聊聊人生。

都看到这了,求个点赞、关注、在看三连呗,感谢支持。

相关推荐
Zԅ(¯ㅂ¯ԅ)7 小时前
C#桌面应用制作计算器
c#
shepherd枸杞泡茶8 小时前
WPF动画
c#·.net·wpf
code_shenbing8 小时前
跨平台WPF框架Avalonia教程 三
前端·microsoft·ui·c#·wpf·跨平台·界面设计
三天不学习8 小时前
C# AutoMapper 10个常用方法总结
c#·automapper·对象映射
oioihoii9 小时前
单例模式详解
c++·单例模式·c#·大学必学
suzh1qian10 小时前
Unity类银河战士恶魔城学习总结(P133 Merge skill tree with Parry skill把技能树和格挡技能相组合)
学习·unity·c#·游戏引擎
sukalot11 小时前
windows C#-异步编程模型(下)
开发语言·windows·c#
zls36536511 小时前
C#开发最快的浏览器,打造极速浏览体验
开发语言·c#
战族狼魂15 小时前
C#的数据类型总结:decimal ,double,float的区别
开发语言·c#
中游鱼15 小时前
万能程序补丁工具 C# 源代码详解
c#·万能程序补丁工具·源代码详解