C# 特性和索引（C#学习笔记06）

特性

特性（Attribute）是用于在运行时传递程序中各种元素（比如类、方法、结构、枚举、组件等）的行为信息的声明性标签。
特性可以当成一个特殊的类看待

列举特性语法：

 [attribute(positional_parameters, name_parameter = value, ...)] 
 element

attribute为特性名称，positional_parameters, name_parameter是特性属性，value为name_parameter属性的值

三种预定义特性：

.Net Framework 提供了三种预定义的特性：

1. AttributeUsage

该特性描述了用户定义的特性类如何被使用
AttributeUsage基本结构:

 [AttributeUsage( validon, 
 AllowMultiple=allowmultiple, 
 Inherited=inherited )]

示例：

 [AttributeUsage(AttributeTargets.Class | 
 AttributeTargets.Constructor | 
 AttributeTargets.Field | 
 AttributeTargets.Method | 
 AttributeTargets.Property, 
 AllowMultiple = true)]

validon规定了该特性能够被承载，或者说是能够被那些类型所使用的声明，如示例中指明了该特性只能在Class（类）,constructor（结构体）,Field（字段），Method（方法），Property（属性）
AllowMutiple规定是否能被重复使用，如果为true则能被重复使用
Inherited规定这个特性是否能被派生类继承，默认false不可继承，true则为可继承

2.Conditional

这个预定义特性标记了一个条件方法，其执行依赖于特定的预处理标识符
它会引起方法调用的条件编译，取决于指定的值，比如 Debug 或 Trace。例如，当调试代码时显示变量的值
Conditional的基本结构：

 [
Conditional( 
 conditionalSymbol 
 )]

使用示例：

#define hong
using System;
using System.Diagnostics;
public class Myclass
{
    [Conditional("hong")]                            //预定义的Conditional特性
    public static void Message(string msg)
    {
        Console.WriteLine(msg);
    }
}
class Test
{
    static void function1()
    {
        Myclass.Message("In Function 1.");
        function2();
    }
    static void function2()
    {
        Myclass.Message("In Function 2.");
    }
    public static void Main()
    {
        Myclass.Message("In Main function.");
        function1();
    }
}

该程序预定义了一个宏:hong，Conditional特性在函数Message中被使用：[Conditional("hong")] 如果没有该宏定义则不会执行函数Message

1. 若定义了宏则程序如上，运行：(Message会被调用）

In Main function.
In Function 1.
In Function 2.
C:C#codeConditionalinDebug
etcoreapp3.0Conditional.exe (进程 18092)已退出，返回代码为: 0。
若要在调试停止时自动关闭控制台，请启用“工具”->“选项”->“调试”->“调试停止时自动关闭控制台”。
按任意键关闭此窗口...

2. 若将第一行定义宏注释：

//#define hong
using System;
using System.Diagnostics;

运行（此时Message函数不会被调用，则没有输出）：

C:C#codeConditionalinDebug
etcoreapp3.0Conditional.exe (进程 18264)已退出，返回代码为: 0。
若要在调试停止时自动关闭控制台，请启用“工具”->“选项”->“调试”->“调试停止时自动关闭控制台”。
按任意键关闭此窗口...

3.Obsolete

这个预定义特性标记了不应被使用的程序实体。它可以让您通知编译器丢弃某个特定的目标元素。例如，当一个新方法被用在一个类中，但是您仍然想要保持类中的旧方法，您可以通过显示一个应该使用新方法，而不是旧方法的消息，来把它标记为 obsolete（过时的）。
Obsolete特性结构：

 [Obsolete(          
 message )] 
 
 [Obsolete(       
 message, 
 iserror )]

message:为描述文字，不使用该函数的原因以及替换函数
iserror:为bool值，true则编译器会把引用了该特性的项目当成错误，产生编译器警告

示例：

    using System;
    public class MyClass
{
    [Obsolete("Don't use OldMethod, use NewMethod instead", true)]
    static void OldMethod()
    {
        Console.WriteLine("It is the old method");
    }
    static void NewMethod()
    {
        Console.WriteLine("It is the new method");
    }
    public static void Main()
    {
        OldMethod();
    }
}

运行编译器会提示错误：

 Don't use OldMethod, use NewMethod instead

创建自定义特性的步骤：

• 声明自定义特性
• 构建自定义特性
• 在目标程序元素上应用自定义特性
• 通过反射访问特性

详细示例在学习完反射后一同进行

反射

反射（Reflection） 对象用于在运行时获取类型信息。该类位于 System.Reflection 命名空间中，可访问一个正在运行的程序的元数据。
System.Reflection 命名空间包含了允许您获取有关应用程序信息及向应用程序动态添加类型、值和对象的类。

反射（Reflection）有下列用途：

1. 它允许在运行时查看属性（attribute）信息。
2. 它允许审查集合中的各种类型，以及实例化这些类型。
3. 它允许延迟绑定的方法和属性（property）。
4. 它允许在运行时创建新类型，然后使用这些类型执行一些任务。

查看元数据

using System;
[AttributeUsage(AttributeTargets.All)]                //规定了特性的能承载所有类型
public class HelpAttribute : System.Attribute         //自定义特性HelpAttribute继承自Attribute基类
{
    public readonly string Url;
    public string Topic   // Topic 是一个表示名字的参数
    {
        get
        {
            return topic;
        }
        set
        {
            topic = value;
        }
    }
    public HelpAttribute(string url)   // url 是一个表示位置的参数
    {
        this.Url = url;
    }
    private string topic;
}
public class OtherAttribute : System.Attribute
{
    public string topic2
    {
        get
        {
            return topic2;
        }
        set
        {
            topic2 = value;
        }
    }
}
[HelpAttribute("Information on the class MyClass")]          //特性被应用到MyClass一个空类中
[OtherAttribute()]                                           //第二个特性
class MyClass
{

}

namespace AttributeAppl
{
    class Program
    {
        static void Main(string[] args)
        {
            System.Reflection.MemberInfo info = typeof(MyClass);          //System.Reflection.MemberInfo初始化
            object[] attributes = info.GetCustomAttributes(true);          //获取目标类(MyClass）所承载的特性
            for (int i = 0; i < attributes.Length; i++)                    //遍历所有特性
            {
                System.Console.WriteLine(attributes[i]);
            }
        }
    }
}

System.Reflection.MemberInfo info = typeof(MyClass);          
System.Reflection.MemberInfo需要初始化，用于与目标类关联（MyClass)

结果:(返回了MyClass类所承载的两个特性)

HelpAttribute
OtherAttribute

C:C#codeFeflectioninDebug
etcoreapp3.0Feflection.exe (进程 6244)已退出，返回代码为: 0。
若要在调试停止时自动关闭控制台，请启用“工具”->“选项”->“调试”->“调试停止时自动关闭控制台”。
按任意键关闭此窗口...

利用特性设置声明信息并用反射进行访问

using System;
using System.Reflection;
namespace attribute
{
    [AttributeUsage(AttributeTargets.Class|            //声明自定义特性，描述自定义特性DebugInfo如何被使用
        AttributeTargets.Constructor|
        AttributeTargets.Field|
        AttributeTargets.Method|
        AttributeTargets.Property,
        AllowMultiple =true)]
    public class DebugInfo : Attribute                 //构建自定义特性
    {
        private int bugNo;          //bug number
        private string developer;
        private string lastReview;  //last reviewed
        public string message;
        public DebugInfo(int BN,string D,string LR)   //构造函数
        {
            this.bugNo = BN;
            this.developer = D;
            this.lastReview = LR;
        }
        public int BugNo
        {
            get
            {
                return bugNo;
            }
        }
        public string Developer
        {
            get
            {
                return developer;
            }
        }
        public string LastReview
        {
            get
            {
                return lastReview;
            }
        }
        public string Message
        {
            set
            {
                message = value;
            }
            get
            {
                return message;
            }
        }
    }
    [DebugInfo(45,"asahi","19/5/1",Message ="can't return type")]          //在目标程序元素上应用自定义特性
    [DebugInfo(50,"Lock","19/9/9",Message ="unable variable")]
    class Rectangle               //矩形类，承载了两个特性
    {
        protected double length;
        protected double width;
        public Rectangle(double L,double W)
        {
            this.length = L;
            this.width = W;
        }
        [DebugInfo(55,"sayo","19/9/15",Message ="return false")]
        public double getArea()
        {
            return length * width;
        }
        [DebugInfo(60,"katsumi","19/10/1",Message ="output error")]
        public void Display()
        {
            Console.WriteLine("Length={0}", length);
            Console.WriteLine("Width={0}", width);
            Console.WriteLine("Area={0}", getArea());
        }
    }
    class Program
    {
        static void Main(string[] args)
        {
            Rectangle r = new Rectangle(10, 5);
            r.Display();                                      

            Type type = typeof(Rectangle);                    //获取Rectangle的类型
            //遍历Rectangle特性
            Console.WriteLine("                   Rectangle类型的特性测试：");
            foreach(object attributes in type.GetCustomAttributes(false))    //获取Rectangle类型的所有特性，迭代的方式赋予attributes
            {
                DebugInfo debugInfo = (DebugInfo)attributes;  //所有特性转换为DebugInfo类型
                if (debugInfo != null)
                {
                    Console.WriteLine("Debug number:{0}", debugInfo.BugNo);
                    Console.WriteLine("Developer:{0}", debugInfo.Developer);
                    Console.WriteLine("Last Review:{0}", debugInfo.LastReview);
                    Console.WriteLine("Message:{0}
", debugInfo.Message);
                }
            }

            Console.WriteLine("           Rectangle类型的所有函数的特性测试：");
            //遍历方法属性
            foreach(MethodInfo m in type.GetMethods())      //遍历type类型即Rectangle类型所有函数
            {
                foreach(object attributes in m.GetCustomAttributes(false))  //遍历每个函数的特性
                {
                    DebugInfo debugInfo = (DebugInfo)attributes;
                    if (debugInfo != null)
                    {
                        Console.WriteLine("Debug number:{0}", debugInfo.BugNo);
                        Console.WriteLine("Developer:{0}", debugInfo.Developer);
                        Console.WriteLine("Last Review:{0}", debugInfo.LastReview);
                        Console.WriteLine("Message:{0}
", debugInfo.Message);
                    }
                }
            }
        }
    }
}

结果：

Length=10
Width=5
Area=50
                   Rectangle类型的特性测试：
Debug number:45
Developer:asahi
Last Review:19/5/1
Message:can't return type

Debug number:50
Developer:Lock
Last Review:19/9/9
Message:unable variable

           Rectangle类型的所有函数的特性测试：
Debug number:55
Developer:sayo
Last Review:19/9/15
Message:return false

Debug number:60
Developer:katsumi
Last Review:19/10/1
Message:output error


C:Program Filesdotnetdotnet.exe (进程 8772)已退出，返回代码为: 0。
若要在调试停止时自动关闭控制台，请启用“工具”->“选项”->“调试”->“调试停止时自动关闭控制台”。
按任意键关闭此窗口...

参考链接：

https://www.w3cschool.cn/wkcsharp/8jib1nvi.html

https://www.w3cschool.cn/wkcsharp/9phg1nvl.html