C#基础系列——Attribute特性使用

前言：上篇 C#基础系列——反射笔记 总结了下反射得基础用法，这章我们来看看C#的另一个基础技术——特性。

1、什么是特性：就博主的理解，特性就是在类的类名称、属性、方法等上面加一个标记，使这些类、属性、方法等具有某些统一的特征，从而达到某些特殊的需要。比如：方法的异常捕捉，你是否还在某些可能出现异常的地方（例如数据库的操作、文件的操作等）经常使用try...catch。这个时候如果使用特性，就可以大大减少方法里面的try...catch的使用。你只需要定义一个专门捕捉异常的特性类ExceptionExAttribute，然后给这个特性类做些特殊处理，比如给它增加一个AOP拦截的功能（AOP拦截的方式很多，有兴趣可以搜搜看，园子里面很多类似的文章）。那么在可能出现异常的方法名称上面加上一个[ExceptionEx]特性标签，这个方法就具有自动捕捉异常的能力。还是加上官方定义：

特性提供功能强大的方法，用以将元数据或声明信息与代码（程序集、类型、方法、属性等）相关联。 特性与程序实体关联后，即可在运行时使用名为“反射”的技术查询特性。

特性具有以下属性：

  • 特性可向程序中添加元数据。 元数据是有关在程序中定义的类型的信息。 所有的 .NET 程序集都包含指定的一组元数据，这些元数据描述在程序集中定义的类型和类型成员。 可以添加自定义特性，以指定所需的任何附加信息。
  • 可以将一个或多个特性应用到整个程序集、模块或较小的程序元素（如类和属性）。
  • 特性可以与方法和属性相同的方式接受参数。
  • 程序可以使用反射检查自己的元数据或其他程序内的元数据。

（以上来自MSDN）

2、为什么需要特性：这个上面已经简单介绍过，特性能大大减少统一需求的代码量。其他不说，至少它能让我们的代码看上去更大气点吧~~

3、特性的使用：博主这次还是打算从三个方便分别介绍下特性的常规使用方法。当然这几种方式都是博主原来用过的，可能不是最好的举例场景，但是也算比较典型的特性用法吧。

（1）类的属性上面特性的用法：

之所以将这个放在最前面介绍是因为博主最近做的一个BS项目正好用到，并且使用场景也比较典型。首先介绍下使用场景：最近项目有一个需求，BS界面需要一个拖拽的功能。如下图

当将左边的3个div拖到右边来时，每个div都有自己的特有属性，比如2部门拖过来时，要显示如下属性：

1和3部门拖过来时可能对应的属性不同。

设计思路：每个div对应的Model，每个Model里面有自己特有的属性，然后属性上面加上特性显示属性的名称和默认值，以及界面应该呈现的html标签。

实现代码：

首先来看自定义的一个特性类：

　　 public class DetailAttribute : Attribute
    {
        public string AttrName { set; get; }
        public string Html { set; get; }
        public string DefaultValue { set; get; }
        public string DataSource { set; get; }
    }

对应的Model：

　　 public class Factory
    {
        [Detail(AttrName="宽度", Html="<input type=‘text‘ />", DefaultValue="50", DataSource=null)]
        public string Width { set; get; }

        [Detail(AttrName = "高度", Html = "<input type=‘text‘ />", DefaultValue = "50", DataSource = null)]
        public string Height { set; get; }

        [Detail(AttrName = "状态", Html = "<select></select>", DefaultValue = null, DataSource = "select text,value from status")]
        public string Status { set; get; }

        [Detail(AttrName = "Tag值", Html = "<input type=‘text‘ />", DefaultValue = "", DataSource = null)]
        public string Tag { set; get; }
    }

    public class FactoryDetail
    {
        [Detail(AttrName = "宽度", Html = "<input type=‘text‘ />", DefaultValue = "50", DataSource = null)]
        public string Width { set; get; }

        [Detail(AttrName = "高度", Html = "<input type=‘text‘ />", DefaultValue = "50", DataSource = null)]
        public string Height { set; get; }

        [Detail(AttrName = "状态", Html = "<select></select>", DefaultValue = null, DataSource = "select text,value from status")]
        public string Status { set; get; }

        [Detail(AttrName = "Tag值", Html = "<input type=‘text‘ />", DefaultValue = "", DataSource = null)]
        public string Tag { set; get; }
        [Detail(AttrName = "描述", Html = "<input type=‘text‘ />", DefaultValue = "", DataSource = null)]
        public string Desc { set; get; }
    }

然后在界面的拖放事件结束时通过js发送ajax请求来得到界面要呈现的html：

$(".jq-draggable-outcontainer").draggable({
        helper: "clone",
        scroll: true,
        drag: function (event, ui) {
            //   debugger;
        }
    });
    $("#content").droppable({
        drop: function (event, ui) {
            //  debugger;
            if (ui.draggable[0].className.indexOf("jq-draggable-outcontainer") > 0) {
                var text = ui.draggable[0].innerText.trim();
                $(this).append(‘<div class="window jq-draggable-incontainer" onclick="GetPropertiesByType(\‘1\‘,this)" style="position:absolute;left:‘ +(event.clientX-20) + ‘px;top:‘ + (event.clientY-20) + ‘px" id="window‘ + iIndex + ‘"><strong>‘ + text + ‘</strong></div>‘);

                $("#content2").html("");
                cur_selector = $("#window"+iIndex);
                $.Ewin.AjaxPost("/Home/GetModelByType", { strType: "Factory" }, function (data, status) {
                    var element = $.parseJSON(data.Json);
                    var arrProp = element.element.property;
                    //0.构造html
                    var strHtml = "<div style=‘float:right;padding-top:0px;width:300px;height:auto;‘><table cellpadding=‘5‘ border=‘1‘>";
                    //1.拼html构造属性
                    strHtml += "</table></div>";
                    $("#content2").append(strHtml);
                }, function () {

                }, null);
                iIndex++;

            }
        }
    });

对应的C#方法：

　　　　 public JsonResult GetModelByType(string strType)
        {　　　　　　　//strType传过来的是Factory或者FactoryDetail
            var assembly = Assembly.Load("Ewin.Client.Web");//参数为程序集的名称
            var oType = assembly.GetType("Ewin.Client.Web.Controllers." + strType);
　　　　　　  //得到类的所有属性
            var lstProperties = oType.GetProperties();
            foreach (var oProperty in lstProperties)
            {　　　　　　　　   //得到每一个属性的特性类集合
                IList<CustomAttributeData> lstAttr = oProperty.GetCustomAttributesData();
                foreach (var oAttr in lstAttr)
                {　　　　　　　　　　　　//得到每一个特性类的全称
                    Console.WriteLine("特性类的名称" + oAttr.AttributeType.FullName);
                    Console.WriteLine("特性类成员如下：");　　　　　　　　　　　　//得到特性类的所有参数
                    var lstAttrArgu = oAttr.NamedArguments;
                    foreach (var oAttrAru in lstAttrArgu)
                    {　　　　　　　　　　　　　　//取每个特性类参数的键值对
                        Console.WriteLine(oAttrAru.MemberName + "=" + oAttrAru.TypedValue.Value);
                    }
                    //Console.WriteLine(oAttr.AttributeType+"——"+oAttr.NamedArguments);
                }
            }
            return Json(new { }, JsonRequestBehavior.AllowGet);
        }

GetModelByType方法结果简单构造下然后将属性的键值对返回给js方法，然后再由js追加到界面上面。这样通过特性和反射的结合能很快完成这个小功能的设计。

（2）类的方法上面特性的用法：

这个用法.Net framework里面就很多，如果MVC里面Filter过滤器的用法：

public class SuperLogStat : ActionFilterAttribute
    {
        //模块名称
        private EnumModuleName moduleEnum = EnumModuleName.ModuleOther;
        //功能名称
        private string functionName = string.Empty;
        //用户Id
        private string userId = string.Empty;

        public string Version
        {
            get { return ConfigurationManager.AppSettings["UploatStatVersion"]; }
        }

        public EnumModuleName ModuleEnum
        {
            get { return this.moduleEnum; }
            set { this.moduleEnum = value; }
        }

        public string FunctionName
        {
            get { return this.functionName; }
            set { this.functionName = value; }
        }

　　

　　   //这两个方法都是父类的virtual方法，一个再return View()之前执行，一个再之后执行
        //
        // 摘要:
        //     在执行操作方法之前由 MVC 框架调用。
        //
        // 参数:
        //   filterContext:
        //     筛选器上下文。
        public override void OnActionExecuting(ActionExecutingContext filterContext)
        {
            try
            {
                string userName = filterContext.HttpContext.User.Identity.Name;
                this.userId = userName.Replace("china\\", "");
            }
            catch (Exception)
            {
                this.userId = string.Empty;
            }
        }

        //
        // 摘要:
        //     在执行操作结果之前由 MVC 框架调用。
        //
        // 参数:
        //   filterContext:
        //     筛选器上下文。
        public override void OnResultExecuting(ResultExecutingContext filterContext)
        {
            UserLogUtils.LogUserStatic(this.userId, this.Version,
                EnumUtils.getEnumDescByValue((int)this.moduleEnum, typeof(EnumModuleName)),
                this.functionName);
        }

    }

在Controller里面方法上面加上特性：

//调用

[SuperLogStat(ModuleEnum = EnumModuleName.ModuleHome, FunctionName = "待审核")]

        public ActionResult MyApplyToAuditing()
        {
            return View();
        }

这个ActionFilterAttribute这个特性用法里面就有异常的拦截机制，和前面说的自定义的异常拦截是相同的。

（3）类上面特性的用法：

类上面特性的用法其实.Net里面也很多。比如为了避免new一个对象而使用的MEF就是一个很有说服力的例子：

在定义个类实现一个接口时：

    [Export("Impc_TB_Test", typeof(Ifc_TB_Test))]
    public class Impc_TB_Test : Ifc_TB_Test
    {
        ......
    }

定义接口没有任何特殊：

    public interface Ifc_TB_Test
    {
        ......
    }

然后在使用时只需要加一个[Import]标签，这个变量就会在编译时自动new一个Impc_TB_Test变量：

[Import("Impc_TB_Test")]
 Ifc_TB_Test service { get; set; }

在使用service变量时，就可以直接把它当做一个Impc_TB_Test对象来使用。是不是很方便。

这几种常见用法都是博主用过的觉得比较好的场景，当然特性的用法肯定远不止如此，欢迎大侠们指正拍砖~~

时间： 2024-08-04 18:17:09

C#基础系列——Attribute特性使用的相关文章

C#基础系列——再也不用担心面试官问我“事件”了

前言:作为.Net攻城狮,你面试过程中是否遇到过这样的问题呢:什么是事件?事件和委托的区别?既然事件作为一种特殊的委托,那么它的优势如何体现?诸如此类...你是否也曾经被问到过?你又是否都答出来了呢?上两篇由浅及深介绍了下委托的用法,这篇还是来说说事件.希望通过这篇的介绍,博友能有个系统的认识,至少应付面试没问题了吧.不信?瞧瞧去~~ C#基础系列目录: C#基础系列——Linq to Xml读写xml C#基础系列——扩展方法的使用 C#基础系列——序列化效率比拼 C#基础系列——反射笔记 C

C#基础系列——一场风花雪月的邂逅：接口和抽象类

前言:最近一个认识的朋友准备转行做编程,看他自己边看视频边学习,挺有干劲的.那天他问我接口和抽象类这两个东西,他说,既然它们如此相像, 我用抽象类就能解决的问题,又整个接口出来干嘛,这不是误导初学者吗.博主呵呵一笑,回想当初的自己,不也有此种疑惑么...今天打算针对他的问题,结合一个实际的使用场景来说明下抽象类和接口的异同,到底哪些情况需要用接口?又有哪些情况需要用抽象类呢? C#基础系列目录: C#基础系列——Linq to Xml读写xml C#基础系列——扩展方法的使用 C#基础系列——序

C#基础系列——小话泛型

前言:前面两章介绍了C#的两个常用技术:C#基础系列——反射笔记 和 C#基础系列——Attribute特性使用 .这一章来总结下C#泛型技术的使用.据博主的使用经历,觉得泛型也是为了重用而生的,并且大部分时候会和反射一起使用.这次还是打算围绕WWH(即What.Why.How)来讲解. 1.什么是泛型:通过参数化类型来实现在同一份代码上操作多种数据类型.利用“参数化类型”将类型抽象化,从而实现灵活的复用.怎么理解呢,其实根据博主的理解,泛型就是将类型抽象化,使用抽象化的类型或对象去实现某些功能

C#基础系列——异步编程初探：async和await

前言:前面有篇从应用层面上面介绍了下多线程的几种用法,有博友就说到了async, await等新语法.确实,没有异步的多线程是单调的.乏味的,async和await是出现在C#5.0之后,它的出现给了异步并行变成带来了很大的方便.异步编程涉及到的东西还是比较多,本篇还是先介绍下async和await的原理及简单实现. C#基础系列目录: C#基础系列——Linq to Xml读写xml C#基础系列——扩展方法的使用 C#基础系列——序列化效率比拼 C#基础系列——反射笔记 C#基础系列——At

C#基础系列：实现自己的ORM（反射以及Attribute在ORM中的应用）

反射以及Attribute在ORM中的应用 一. 反射什么是反射?简单点吧,反射就是在运行时动态获取对象信息的方法,比如运行时知道对象有哪些属性,方法,委托等等等等.反射有什么用呢?反射不但让你在运行是获取对象的信息,还提供运行时动态调用对象方法以及动态设置.获取属性等的能力.反射在ORM中有什么用呢?我这里所讨论的ORM实现是通过自定义Attribute的方式进行映射规则的描述的.但是我们并不知道具体哪个对象需要对应哪个表,并且这些对象是独立于我们的ORM框架的,所以我们只能通过自定义Attr

.NET基础编程之特性 - Attribute

这一篇文章是给大家介绍的是:.NET基础编程之特性 - Attribute,对这一部分掌握不熟悉的同学,可以仔细的看一下! 一.特性简介 特性提供功能强大的方法,用以将元数据或声明信息与代码(程序集.类型.方法.属性等)相关联.特性与程序实体关联后,可在运行时使用"反射"查询特性. 特性具有以下属性: (1)特性可向程序中添加元数据.元数据是有关在程序中定义的类型的信息.所有的 .NET 程序集都包含指定的一组元数据,这些元数据描述在程序集中定义的类型和类型成员.可以添加自定义特性,以

夯实Java基础系列4：一文了解final关键字的特性、使用方法，以及实现原理

目录 final使用 final变量 final修饰基本数据类型变量和引用 final类 final关键字的知识点 final关键字的最佳实践 final的用法 关于空白final final内存分配 使用final修饰方法会提高速度和效率吗 使用final修饰变量会让变量的值不能被改变吗: 如何保证数组内部不被修改 final方法的三条规则 final 和 jvm的关系 写 final 域的重排序规则 读 final 域的重排序规则 如果 final 域是引用类型 参考文章 微信公众号 Jav

Attribute特性验证模型model

数据验证我们往往分为前台验证和后台验证,而我们的后台验证每到一个方法中就要去验证一次,这样的代码想想都难以维护,这篇我们这篇文章就是为了解决这样的问题.用attribute 这个特性来解决这样的问题 也将在这篇文章中告诉大家如何编写. 调用方式: UserService applictionService = container.Resolve<UserService>(); applictionService.AddUser(new User() { Name = "1"

Scrum入门基础系列之Scrum工件

Scrum入门基础系列之Scrum工件 3条回复 Scrum工件主要包含一下3种: 产品Backlog Sprint Backlog 产品增量 产品Backlog 在Scrum中,主要由产品负责人[参见Scrum入门基础系列之Scrum角色]整理和维护产品Backlog.产品Backlog是Scrum中维护需求的主要工件,也是做好Scrum的第一步.一个好的产品Backlog,是要符合DEEP原则的,即,产品Backlog是详略得当的(Detailed Appropriate),涌现的(Emer