c# 反射之特性(Attribute)使用

1、序列化：
[Serializable]
public void 方法名(){...}

2、WebServices方法：
[WebMethod]
public void 方法名(){...}

3、Ajax(AjaxPro)方法：
[AjaxPro.AjaxMethod]
public void 方法名(){...}

4、其他还有很多，如Duwamish7里的：
[Browsable(false)]
public void 方法名(){...}

特性介绍

特性（Attributes）是一种崭新的声明性信息。我们不仅可以通过特性来定义设计层面的信息（例如help file, URL for documentation）以及运行时（run-time）信息（例如使XML与class相联系），而且我们还可以利用特性建立自描述（self- describing）组件。在这篇教程中，我们将会看到如何建立和添加特性到各种程序实体以及如何在运行时环境中获取特性信息。
   定义
   正如MSDN中所描述的那样-----  
   “特性是被指定给某一声明的一则附加的声明性信息。”

  
  1、使用预定义（Pre-defined）特性  

  在C#中，有一个小的预定义特性集合。在学习如何建立我们自己的定制特性（custom attributes）之前，我们先来看看在我们的代码中如何使用预定义特性。 

using System;
  public class AnyClass
  {
   [Obsolete("Don't use Old method, use New method", true)]
   static void Old( ) { }  
   static void New( ) { }  
   public static void Main( )
   {
   Old( );
   }
  }

我们先来看一下上面这个例子，在这个例子中我们使用了Obsolete特性，它标记了一个不应该再被使用的程序实体。第一个参数是一个字符串，它解释了为什么该实体是过时的以及应该用什么实体来代替它。实际上，你可以在这里写任何文本。第二个参数告诉编译器应该把使用这个过时的程序实体当作 一种错误。它的默认值是false，也就是说编译器对此会产生一个警告。  
  当我们尝试编译上面这段程序的时候，我们将会得到一个错误：  
  AnyClass.Old()' is obsolete: 'Don't use Old method, use New method'    

  2、开发定制特性（custom attributes） 

  现在让我们来看看如何开发我们自己的特性。 
  首先我们要从System.Attribute派生出我们自己的特性类（一个从System.Attribute抽象类继承而来的类，不管是直接还是间接继承，都会成为一个特性类。特性类的声明定义了一种可以被放置在声明之上新的特性）。  

  using System;
  public class HelpAttribute : Attribute
  {
  }

  不管你是否相信，我们已经建立了一个定制特性，现在我们可以用它来装饰现有的类就好像上面我们使用Obsolete attribute一样。  

  [Help()]
  public class AnyClass
  {
  }

  注意：对一个特性类名使用Attribute后缀是一个惯例。然而，当我们把特性添加到一个程序实体，是否包括Attribute后缀是我们 的自由。编译器会首先在System.Attribute的派生类中查找被添加的特性类。如果没有找到，那么编译器会添加Attribute后缀继续查 找。  
  到目前为止，这个特性还没有起到什么作用。下面我们来添加些东西给它使它更有用些。 

using System;
  public class HelpAttribute : Attribute
  {
   public HelpAttribute(String Descrition_in)
   {
   this.description = Description_in;
   }
   protected String description;
   public String Description
   {
   get
   {
   return this.description;  
   }
   }
  }
  [Help("this is a do-nothing class")]
  public class AnyClass
  {
  }

   在上面的例子中，我们给HelpAttribute特性类添加了一个属性并且在后续的部分中我们会在运行时环境中查寻它。

3、使用反射访问特性 (C#)

通过使用反射，可以检索通过自定义特性定义的信息。 主要方法是 GetCustomAttributes，它返回对象数组，这些对象在运行时等效于源代码特性。 此方法有多个重载版本。 有关详细信息，请参阅 Attribute。

示例

此处是一个完整的示例。 定义自定义特性、将其应用于多个实体，并通过反射对其进行检索。

// Multiuse attribute.  
[System.AttributeUsage(System.AttributeTargets.Class |  
                       System.AttributeTargets.Struct,  
                       AllowMultiple = true)  // Multiuse attribute.  
]  
public class Author : System.Attribute  
{  
    string name;  
    public double version;  
  
    public Author(string name)  
    {  
        this.name = name;  
  
        // Default value.  
        version = 1.0;  
    }  
  
    public string GetName()  
    {  
        return name;  
    }  
}  
  
// Class with the Author attribute.  
[Author("P. Ackerman")]  
public class FirstClass  
{  
    // ...  
}  
  
// Class without the Author attribute.  
public class SecondClass  
{  
    // ...  
}  
  
// Class with multiple Author attributes.  
[Author("P. Ackerman"), Author("R. Koch", version = 2.0)]  
public class ThirdClass  
{  
    // ...  
}  
  
class TestAuthorAttribute  
{  
    static void Test()  
    {  
        PrintAuthorInfo(typeof(FirstClass));  
        PrintAuthorInfo(typeof(SecondClass));  
        PrintAuthorInfo(typeof(ThirdClass));  
    }  
  
    private static void PrintAuthorInfo(System.Type t)  
    {  
        System.Console.WriteLine("Author information for {0}", t);  
  
        // Using reflection.  
        System.Attribute[] attrs = System.Attribute.GetCustomAttributes(t);  // Reflection.  
  
        // Displaying output.  
        foreach (System.Attribute attr in attrs)  
        {  
            if (attr is Author)  
            {  
                Author a = (Author)attr;  
                System.Console.WriteLine("   {0}, version {1:f}", a.GetName(), a.version);  
            }  
        }  
    }  
}  
/* Output:  
    Author information for FirstClass  
       P. Ackerman, version 1.00  
    Author information for SecondClass  
    Author information for ThirdClass  
       R. Koch, version 2.00  
       P. Ackerman, version 1.00  
*/