• C#反射的特性


    如果您现在对反射还不太了解的话,那么可以先看看这篇博文,来粗略的了解一下反射吧。什么是反射

      反射特性(Attribute) 

    1. C#内置特性介绍
      特性是一个对象,它可以加载到程序集及程序集的对象中,这些对象包括 程序集本身、模块、类、接口、结构、构造函数、方法、方法参数等,加载了特性的对象称作特性的目标。特性是为程序添加元数据(描述数据的数据)的一种机制,通过它可以给编译器提供指示或者提供对数据的说明。

    注意:特性的英文名称叫做Attribute,在有的书中,将它翻译为“属性”;另一些书中,将它翻译为“特性”;由于通常我们将含有get和/或set访问器的类成员称为“属性”(英文Property),所以本文中我将使用“特性”这个名词,以区分“属性”(Property)。  

    上面这个提示是在VS中的,大家在编程的过程中应该有遇到过的。

    下面我们就引入第一个特性

    1.1 System.ObsoleteAttribute 特性

    我们通过如图示这个例子来看一下特性是如何解决上面的问题:我们可以给旧的SendMsg()方法上面加上Obsolete特性来告诉编译器这个方法已经过时,然后当编译器发现当程序中有地方在使用这个用Obsolete标记过的方法时,就会给出一个警告信息。

    namespace TestObsolete
    {
        class Program
        {
            public class Message { }
    
            public class TestClass
            {
                // 添加Obsolete特性
                [Obsolete("请使用新的SendMsg(Message msg)重载方法")]
                public static void ShowMsg()
                {
                    Console.WriteLine("这是旧的SendMsg()方法");
                }
    
                public static void ShowMsg(Message msg)
                {
                    Console.WriteLine("新SendMsg()方法");
                }
    
            }
            static void Main(string[] args)
            {
                TestClass.ShowMsg();
                TestClass.ShowMsg(new Message());
            }
        }
    }
    

     简单的代码如上。现在运行这段代码,我们会发现编译器给出了一个警告:警告CS0618: “Attribute.TestClass.ShowMsg()”已过时:“请使用新的SendMsg(Message msg)重载方法”。通过使用特性,我们可以看到编译器给出了警告信息,告诉客户程序存在一个新的方法可供使用,这样,程序员在看到这个警告信息后,便会考虑使用新的SendMsg()方法。

    1.2 特性的使用方法

      通过上面的例子,我们已经大致看到特性的使用方法:首先是有一对方括号“[]”,在左方括号“[”后紧跟特性的名称,比如Obsolete,随后是一个圆括号“()”。和普通的类不同,这个圆括号不光可以写入构造函数的参数,还可以给类的属性赋值,在Obsolete的例子中,仅传递了构造函数参数。

    注意:

    实际上,当你用鼠标框选住Obsolete,然后按下F12转到定义,会发现它的全名是ObsoleteAttribute,继承自Attribute类。但是这里却仅用Obsolete来标记方法,这是.Net的一个约定,所有的特性应该均以Attribute来结尾,在为对象标记特性时如果没有添加Attribute,编译器会自动寻找带有Attribute的版本。

     

    使用构造函数参数,参数的顺序必须同构造函数声明时的顺序相同,所有在特性中也叫位置参数(Positional Parameters),与此相应,属性参数也叫做命名参数(Named Parameters)。在下面会详细说明。

    2.自定义特性(Custom Attributes)

    2.1范例介绍

    如果不能自己定义一个特性并使用它,我想你怎么也不能很好的理解特性,我们现在就自己构建一个特性。假设我们有这样一个很常见的需求:我们在创建或者更新一个类文件时,需要说明这个类是什么时候、由谁创建的,在以后的更新中还要说明在什么时候由谁更新的,可以记录也可以不记录更新的内容,以往你会怎么做呢?是不是像这样在类的上面给类添加注释:

        [Record("更新", "Leo", "2013-3-20", Memo = "修改……")]
        [Record("创建", "Amy", "2013-3-10")]
        [Record("更新", "aehyok", "2013-3-18")]
        public class DemoClass
        {
            public override string ToString()
            {
                return "This is a demo class";
            }
        }
    

     这样的的确确是可以记录下来,但是如果有一天我们想将这些记录保存到数据库中作以备份呢?你是不是要一个一个地去查看源文件,找出这些注释,再一条条插入数据库中呢?

    通过上面特性的定义,我们知道特性可以用于给类型添加元数据,这些元数据可以用于描述类型。那么在此处,特性应该会派上用场。那么在本例中,元数据应该是:注释类型(“更新”或者“创建”),修改人,日期,备注信息(可有可无)。而特性的目标类型是DemoClass类。

    按照对于附加到DemoClass类上的元数据的理解,我们先创建一个封装了元数据的类RecordAttribute:

        public class RecordAttribute
        {
            private string recordType;      // 记录类型:更新/创建
            private string author;          // 作者
            private DateTime date;          // 更新/创建 日期
    
            // 构造函数,构造函数的参数在特性中也称为“位置参数”。
            public RecordAttribute(string recordType, string author, string date)
            {
                this.recordType = recordType;
                this.author = author;
                this.date = Convert.ToDateTime(date);
            }
    
            // 对于位置参数,通常只提供get访问器
            public string RecordType { get { return recordType; } }
            public string Author { get { return author; } }
            public DateTime Date { get { return date; } }
    
            // 
            public string Memo { get; set; }
        }
    

     这个类不光看上去,实际上也和普通的类没有任何区别,显然不能它因为名字后面跟了个Attribute就摇身一变成了特性。那么怎样才能让它称为特性并应用到一个类上面呢?进行下一步之前,我们看看.Net内置的特性Obsolete是如何定义的:

        // 摘要:
        //     标记不再使用的程序元素。无法继承此类。
        [Serializable]
        [ComVisible(true)]
        [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Enum | AttributeTargets.Constructor | AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Event | AttributeTargets.Interface | AttributeTargets.Delegate, Inherited = false)]
        public sealed class ObsoleteAttribute : Attribute
        {
            // 摘要:
            //     使用默认属性初始化 System.ObsoleteAttribute 类的新实例。
            public ObsoleteAttribute();
            //
            // 摘要:
            //     使用指定的变通方法消息初始化 System.ObsoleteAttribute 类的新实例。
            //
            // 参数:
            //   message:
            //     描述可选的变通方法的文本字符串。
            public ObsoleteAttribute(string message);
            //
            // 摘要:
            //     使用变通方法消息和布尔值初始化 System.ObsoleteAttribute 类的新实例,该布尔值指示是否将使用已过时的元素视为错误。
            //
            // 参数:
            //   message:
            //     描述可选的变通方法的文本字符串。
            //
            //   error:
            //     指示是否将使用已过时的元素视为错误的布尔值。
            public ObsoleteAttribute(string message, bool error);
    
            // 摘要:
            //     获取指示编译器是否将使用已过时的程序元素视为错误的布尔值。
            //
            // 返回结果:
            //     如果将使用已过时的元素视为错误,则为 true;否则为 false。默认为 false。
            public bool IsError { get; }
            //
            // 摘要:
            //     获取变通方法消息,包括对可选程序元素的说明。
            //
            // 返回结果:
            //     变通方法文本字符串。
            public string Message { get; }
        }
    }
    

     2.2添加特性的格式(位置参数和命名参数)

    首先,我们应该发现,它继承自Attribute类,这说明我们的RecordAttribute也应该继承自Attribute类。

    其次,我们发现在这个特性的定义上,又用了三个特性去描述它。这三个特性分别是:Serializable、AttributeUsage 和 ComVisible。Serializable特性应该主要是用来序列化用的,ComVisible简单来说是“控制程序集中个别托管类型、成员或所有类型对 COM 的可访问性”(微软给的定义)。这里我们应该注意到:特性本身就是用来描述数据的元数据,而这三个特性又用来描述特性,所以它们可以认为是“元数据的元数据”(元元数据:meta-metadata)。

    因为我们需要使用“元元数据”去描述我们定义的特性 RecordAttribute,所以现在我们需要首先了解一下“元元数据”。这里应该记得“元元数据”也是一个特性,大多数情况下,我们只需要掌握 AttributeUsage就可以了,所以现在就研究一下它。我们首先看上面AttributeUsage是如何加载到ObsoleteAttribute特性上面的。

     [AttributeUsage(8192, Inherited = false)]
    

    然后我们看一下AttributeUsage的定义:

        // 摘要:
        //     指定另一特性类的用法。无法继承此类。
        [Serializable]
        [ComVisible(true)]
        [AttributeUsage(AttributeTargets.Class, Inherited = true)]
        public sealed class AttributeUsageAttribute : Attribute
        {
            // 摘要:
            //     用指定的 System.AttributeTargets、System.AttributeUsageAttribute.AllowMultiple
            //     值和 System.AttributeUsageAttribute.Inherited 值列表初始化 System.AttributeUsageAttribute
            //     类的新实例。
            //
            // 参数:
            //   validOn:
            //     使用按位“或”运算符组合的一组值,用于指示哪些程序元素是有效的。
            public AttributeUsageAttribute(AttributeTargets validOn);
    
            // 摘要:
            //     获取或设置一个布尔值,该值指示能否为一个程序元素指定多个指示特性实例。
            //
            // 返回结果:
            //     如果允许指定多个实例,则为 true;否则为 false。默认为 false。
            public bool AllowMultiple { get; set; }
            //
            // 摘要:
            //     获取或设置一个布尔值,该值指示指示的特性能否由派生类和重写成员继承。
            //
            // 返回结果:
            //     如果该特性可由派生类和重写成员继承,则为 true,否则为 false。默认为 true。
            public bool Inherited { get; set; }
            //
            // 摘要:
            //     获取一组值,这组值标识指示的特性可应用到的程序元素。
            //
            // 返回结果:
            //     一个或多个 System.AttributeTargets 值。默认为 All。
            public AttributeTargets ValidOn { get; }
        }
    

     可以看到,它有一个构造函数,这个构造函数含有一个AttributeTargets类型的位置参数(Positional Parameter)。注意ValidOn属性不是一个命名参数,因为它不包含set访问器。

    这里大家一定疑惑为什么会这样划分参数,这和特性的使用是相关的。假如AttributeUsageAttribute 是一个普通的类,我们一定是这样使用的:

    // 实例化一个 AttributeUsageAttribute 类
    AttributeUsageAttribute usage=new AttributeUsageAttribute(AttributeTargets.Class)
    ;
    usage.AllowMultiple = true;  // 设置AllowMutiple属性
    usage.Inherited = false;// 设置Inherited属性
    

     但是,特性只写成一行代码,然后紧靠其所应用的类型(目标类型),那么怎么办呢?微软的软件工程师们就想到了这样的办法:不管是构造函数的参数 还是 属性,统统写到构造函数的圆括号中,对于构造函数的参数,必须按照构造函数参数的顺序和类型;对于属性,采用“属性=值”这样的格式,它们之间用逗号分隔。于是上面的代码就减缩成了这样:

    [AttributeUsage(AttributeTargets.Class, AllowMutiple=true, Inherited=false)]
    

    可以看出,AttributeTargets.Class是构造函数参数(位置参数),而AllowMutiple 和 Inherited实际上是属性(命名参数)。命名参数是可选的。将来我们的RecordAttribute的使用方式于此相同。(为什么管他们叫参数,我猜想是因为它们的使用方式看上去更像是方法的参数吧。)

    假设现在我们的RecordAttribute已经OK了,则它的使用应该是这样的:

        [Record("创建", "Amy", "2013-3-10","创建Test")]
        public class DemoClass
    

     其中recordType, author 和 date 是位置参数,Memo是命名参数。

    2.3 AttributeTargets 位标记

    从AttributeUsage特性的名称上就可以看出它用于描述特性的使用方式。具体来说,首先应该是其所标记的特性可以应用于哪些类型或者对象。从上面的代码,我们看到AttributeUsage特性的构造函数接受一个 AttributeTargets 类型的参数,那么我们现在就来了解一下AttributeTargets。

    AttributeTargets 是一个位标记,它定义了特性可以应用的类型和对象。

        // 摘要:
        //     指定可以对它们应用特性的应用程序元素。
        [Serializable]
        [Flags]
        [ComVisible(true)]
        public enum AttributeTargets
        {
            // 摘要:
            //     可以对程序集应用特性。
            Assembly = 1,
            //
            // 摘要:
            //     可以对模块应用特性。
            Module = 2,
            //
            // 摘要:
            //     可以对类应用特性。
            Class = 4,
            //
            // 摘要:
            //     可以对结构应用特性,即值类型。
            Struct = 8,
            //
            // 摘要:
            //     可以对枚举应用特性。
            Enum = 16,
            //
            // 摘要:
            //     可以对构造函数应用特性。
            Constructor = 32,
            //
            // 摘要:
            //     可以对方法应用特性。
            Method = 64,
            //
            // 摘要:
            //     可以对属性应用特性。
            Property = 128,
            //
            // 摘要:
            //     可以对字段应用特性。
            Field = 256,
            //
            // 摘要:
            //     可以对事件应用特性。
            Event = 512,
            //
            // 摘要:
            //     可以对接口应用特性。
            Interface = 1024,
            //
            // 摘要:
            //     可以对参数应用特性。
            Parameter = 2048,
            //
            // 摘要:
            //     可以对委托应用特性。
            Delegate = 4096,
            //
            // 摘要:
            //     可以对返回值应用特性。
            ReturnValue = 8192,
            //
            // 摘要:
            //     可以对泛型参数应用特性。
            GenericParameter = 16384,
            //
            // 摘要:
            //     可以对任何应用程序元素应用特性。
            All = 32767,
        }
    

     现在应该不难理解为什么上面我范例中用的是:

    [AttributeUsage(AttributeTargets.Class, AllowMutiple=true, Inherited=false)]
    

     而ObsoleteAttribute特性上加载的 AttributeUsage是这样的:

    [AttributeUsage(8192, Inherited = false)]
    

     因为AttributeUsage是一个位标记,所以可以使用按位或“|”来进行组合。所以,当我们这样写时:

    [AttributeUsage(AttributeTargets.Class|AttributeTargets.Interface)
    

     意味着既可以将特性应用到类上,也可以应用到接口上。

    注意:这里存在着两个特例:观察上面AttributeUsage的定义,说明特性还可以加载到程序集Assembly和模块Module上,而这两个属于我们的编译结果,在程序中并不存在这样的类型,我们该如何加载呢?可以使用这样的语法:[assembly:SomeAttribute(parameter list)],另外这条语句必须位于程序语句开始之前。

    2.4 Inherited 和 AllowMutiple属性

    AllowMutiple 属性用于设置该特性是不是可以重复地添加到一个类型上(默认为false),就好像这样:

        [Record("更新", "Leo", "2013-3-20", Memo = "修改……")]
        [Record("更新", "aehyok", "2013-3-18")]
        [Record("创建", "Amy", "2013-3-10")]
        public class DemoClass
        {
    

     所以,我们必须显示的将AllowMutiple设置为True。

    Inherited 就更复杂一些了,假如有一个类继承自我们的DemoClass,那么当我们将RecordAttribute添加到DemoClass上时,DemoClass的子类也会获得该特性。而当特性应用于一个方法,如果继承自该类的子类将这个方法覆盖,那么Inherited则用于说明是否子类方法是否继承这个特性。

    在我们的例子中,将 Inherited 设为false。

    2.5 实现 RecordAttribute

    现在实现RecordAttribute应该是非常容易了,对于类的主体不需要做任何的修改,我们只需要让它继承自Attribute基类,同时使用AttributeUsage特性标记一下它就可以了(假定我们希望可以对类和方法应用此特性):

        [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = false)]
        public class RecordAttribute:Attribute
        {
            private string recordType;      // 记录类型:更新/创建
            private string author;          // 作者
            private DateTime date;          // 更新/创建 日期
    
            // 构造函数,构造函数的参数在特性中也称为“位置参数”。
            public RecordAttribute(string recordType, string author, string date)
            {
                this.recordType = recordType;
                this.author = author;
                this.date = Convert.ToDateTime(date);
            }
    
            // 对于位置参数,通常只提供get访问器
            public string RecordType { get { return recordType; } }
            public string Author { get { return author; } }
            public DateTime Date { get { return date; } }
    
            // 构建一个属性,在特性中也叫“命名参数”
            public string Memo { get; set; }
        }
    

     2.6 使用 RecordAttribute

        [Record("更新", "Leo", "2013-3-20", Memo = "修改……")]
        [Record("更新", "aehyok", "2013-3-18")]
        [Record("创建", "Amy", "2013-3-10")]
        public class DemoClass
        {
            public override string ToString()
            {
                return "This is a demo class";
            }
        }
        class Program
        {
            static void Main(string[] args)
            {
                DemoClass demo = new DemoClass();
                Console.WriteLine(demo.ToString());
    

     这段程序简单地在屏幕上输出一个“This is a demo class”。我们的属性也好像使用“//”来注释一样对程序没有任何影响,实际上,我们添加的数据已经作为元数据添加到了程序集中。

    3.使用反射查看自定义特性

    利用反射来查看 自定义特性信息 与 查看其他信息 类似,首先基于类型(本例中是DemoClass)获取一个Type对象,然后调用Type对象的GetCustomAttributes()方法,获取应用于该类型上的特性。当指定GetCustomAttributes(Type attributeType, bool inherit) 中的第一个参数attributeType时,将只返回指定类型的特性,否则将返回全部特性;第二个参数指定是否搜索该成员的继承链以查找这些属性。

                Type t = typeof(DemoClass);
                Console.WriteLine("下面列出应用于 {0} 的RecordAttribute属性:", t);
    
                // 获取所有的RecordAttributes特性
                object[] records = t.GetCustomAttributes(typeof(RecordAttribute), false);
    
                foreach (RecordAttribute record in records)
                {
                    Console.WriteLine("   {0}", record);
                    Console.WriteLine("      类型:{0}", record.RecordType);
                    Console.WriteLine("      作者:{0}", record.Author);
                    Console.WriteLine("      日期:{0}", record.Date.ToShortDateString());
                    if (!String.IsNullOrEmpty(record.Memo))
                    {
                        Console.WriteLine("      备注:{0}", record.Memo);
                    }
                }
    

     下面来看一下最后的执行效果

     

    这是实例代码下载连接示例代码

  • 相关阅读:
    怎么查看京东店铺的品牌ID
    PPT编辑的时候很卡,放映的时候不卡,咋回事?
    codevs 1702素数判定2
    codevs 2530大质数
    codevs 1488GangGang的烦恼
    codevs 2851 菜菜买气球
    hdu 5653 Bomber Man wants to bomb an Array
    poj 3661 Running
    poj 1651 Multiplication Puzzle
    hdu 2476 String Painter
  • 原文地址:https://www.cnblogs.com/aehyok/p/2969010.html
Copyright © 2020-2023  润新知