C# Method Attribute and Reflection

　　在C#中，许多地方都用到了特征属性Attribute，它可以用来描述类型或方法，从而赋予它们一些额外的功能或特性。事实上，当你打开Visual Studio并创建一个Windows Forms Application应用程序时，在默认的Program.cs文件中，Main函数就被标记上了特征属性。

[STAThread]
static void Main()
{
}

　　特征属性是一组继承自Attribute的类，通常被用来修饰类型或方法，在类型或方法定义之前以方括号括起来。如我们可以给类的属性添加特征属性使其可以被序列化为XML：

public class Movie
{
  [XmlElement("MovieName")]
  public string Title
  { get; set; }

  [XmlElement("MovieRating")]
  public float Rating
  { get; set; }

  [XmlElement("MovieReleaseDate")]
  public DateTime ReleaseDate
  { get; set; }
}

　　如同上面的代码片段，特征属性允许接收参数，这要取决于你使用了什么样的特征属性类型。当然，在.NET中我们也可以自定义特征属性类，但前提是自定义类必须继承自Attribute类。下面是一个例子：

class MyToken : Attribute
{
  public string DisplayName { get; set; }

  public MyToken(string dn)
  { DisplayName = dn; }
}

　　然后，我们在代码中使用上面我们自定义的特征属性类：

public static class Operations
{
  [MyToken("Operation 1")]
  public static void Operation1()
  {
    System.Windows.Forms.MessageBox.Show("Hey, I'm operation 1!");
  }

  [MyToken("Operation 2")]
  public static void Operation2()
  {
    System.Windows.Forms.MessageBox.Show("Hey, I'm operation 2!");     
  }
}

　　那么我们在方法前使用我们自定义的特征属性有什么意义呢？来看看一个实际的例子，我们通过反射来找出所有被标记成我们自定义的特征属性的方法。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.Reflection;

namespace WindowsFormsApplication1
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            PopulateComBox();
        }

        private void PopulateComBox()
        {
            MethodInfo[] methods = typeof(Operations).GetMethods();

            MyToken token = null;
            List<KeyValuePair<String, MethodInfo>> items = new List<KeyValuePair<string, MethodInfo>>();

            foreach (MethodInfo method in methods)
            {
                token = Attribute.GetCustomAttribute(method, typeof(MyToken), false) as MyToken;
                if (token == null)
                {
                    continue;
                }

                items.Add(new KeyValuePair<String, MethodInfo>(token.DisplayName, method));
            }

            this.comboBox1.DataSource = items;
            this.comboBox1.DisplayMember = "Key";
            this.comboBox1.ValueMember = "Value";
        }

        private void button1_Click(object sender, EventArgs e)
        {
            if (this.comboBox1.SelectedIndex < 0)
            {
                return;
            }

            MethodInfo method = this.comboBox1.SelectedValue as MethodInfo;
            if (method != null)
            {
                method.Invoke(null, null);
            }
        }
    }

    public class MyToken : Attribute
    {
        public string DisplayName { get; set; }

        public MyToken(string dn)
        { DisplayName = dn; }
    }

    public static class Operations
    {
        [Obsolete]
        public static void Operation0()
        {
            System.Windows.Forms.MessageBox.Show("Hey, I'm operation 0!");
        }

        [MyToken("Operation 1")]
        public static void Operation1()
        {
            System.Windows.Forms.MessageBox.Show("Hey, I'm operation 1!");
        }

        [MyToken("Operation 2")]
        public static void Operation2()
        {
            System.Windows.Forms.MessageBox.Show("Hey, I'm operation 2!");
        }

        public static void Operation3()
        {
            System.Windows.Forms.MessageBox.Show("Hey, I'm operation 3!");
        }
    }
}

　　上面是一个WinForm程序的完整代码，窗体上一共两个控件，一个Combox，一个Button。程序启动时调用PopulateComBox()方法，通过反射找出Operations类中所有被标记为MyToken特征属性的方法，添加到集合List中。这里有两个地方需要说明一下：

　　1. 通过Attribute.GetCustomAttribute()方法尝试找到MethodInfo[]数组中所有被标记为MyToken特征属性的方法。注意GetCustomAttribute()方法的参数形式。typeof(Operations).GetMethods()用来返回类型Operations中所有public访问级别的方法。

　　2. 集合items被定义为List泛型类型，该List泛型类型被指定为具有名值对的形式。实际上你也可以使用任何具有名值对的集合类型，如Hashtable。

　　当点击按钮的时候，程序通过ComBox.SelectedValue属性找到当前选中的方法名称，然后使用Invoke()方法执行它，下面是程序执行时的效果截图。

 

　　你应该注意到了在ComBox中只有两项：Operation1和Operation2。但是我们看到Operations类中一共有四个被定义为public访问级别的static方法，为什么反射只找到了两个方法呢？这是因为我们在反射中规定只找出被定义为MyToken特征属性的方法，方法Operation0被定义为特征属性Obsolete（该特征属性用于标识方法已过期并不再使用，你应该在一些早期.NET版本中发布的类型或方法中见过这个标识，或者在代码的智能提示中见过它）而非MyToken，方法Operation3不包含有特征属性。

　　反射的最大好处就是可以动态地加载程序集，并获取程序集中的类型，以及类型中的属性和方法，并执行它们。在上例中，如果你想添加一个新的Operation方法并让它在ComBox中出现且能被执行，你只需要做一件事情，那就是在Operations类中增加一个方法并标注为MyToken特征属性，同时加上一些你期待执行的代码。