C#特性

特性(

Attribute

)是用于在运行时传递程序中各种元素（比如类、方法、结构、枚举、组件等）的行为信息的声明性标签。

特性(

Attribute

)用于添加元数据，如编译器指令和注释、描述、方法、类等其他信息。元数据是程序中定义的类型的相关信息。 所有 .NET 程序集都包含一组指定的元数据，用于描述程序集中定义的类型和类型成员。 可以添加自定义特性来指定所需的其他任何信息

.NET框架中一些预定义的特性

• Obsolete

  -标记某个type过时了

• WebMethod

  -公开

  WebService

  方法

• Serializable

  -表示某个类可以被序列化

Obsolete

的使用参考Part 52 - C# Tutorial - Attributes in C#

例如，可以使用

Obsolete

标记某个方法已经过时了，提示其使用新的方法代替

[Obsolete("Use Add(List<int> Numbers) instead")]
public static int Add(int FirstNumber, int SecondNumber)
           

Obsolete

还有一个属性

error

，指定为

true

的话，就不是警告了，而是错误，甚至不能编译程序

[Obsolete("Use Add(List<int> Numbers) instead", true)]
public static int Add(int FirstNumber, int SecondNumber)
           

AttributeUsage

参考:

• C# 特性（Attribute）
• AttributeUsage (C#)

AttributeUsage

是 AttributeUsageAttribute 的别名。

预定义特性

AttributeUsage

描述了如何使用一个自定义特性类。它规定了特性可应用到的项目的类型。

[System.AttributeUsage(System.AttributeTargets.All,  
                   AllowMultiple = false,  
                   Inherited = true)]  
class NewAttribute : System.Attribute { }  
           

参数的含义:

• AttributeUsage

  -规定特性可被放置的语言元素。默认是

  AttributeTargets.All

  。必须是 AttributeTargets 枚举的一个或多个元素。 可将多个目标类型与 OR 运算符链接在一起，如下所示：

  [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]  
  class NewPropertyOrFieldAttribute : Attribute { } 
             

• AllowMultiple

  -如果为 true，则该特性是多用的。默认值是 false（单用的）

  [AttributeUsage(AttributeTargets.Class, AllowMultiple = true)]  
  class MultiUseAttr : Attribute { }  
  
  [MultiUseAttr]  
  [MultiUseAttr]  
  class Class1 { }  
  
  [MultiUseAttr, MultiUseAttr]  
  class Class2 { } 
             

• inherited

  -如果为 true，则该特性可被派生类继承。默认值是 false（不被继承）

自定义特性

参考：

• 创建自定义特性 (C#)
• C# 特性（Attribute）

可通过定义特性类创建自己的自定义特性，特性类是直接或间接派生自 Attribute 的类，可快速轻松地识别元数据中的特性定义。

创建并使用自定义特性包含四个步骤：

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

自定义

Author

特性类

[System.AttributeUsage(System.AttributeTargets.Class |  
                       System.AttributeTargets.Struct)  
]  
public class Author : System.Attribute  
{  
    private string name;  
    public double version;  

    public Author(string name)  
    {  
        this.name = name;  
        version = ;  
    }  
} 
           

使用

AttributeUsage

特性可使

Author

特性仅对类和

struct

声明有效。

可按如下方式使用这一新特性：

[Author("P. Ackerman", version = )]  
class SampleClass  
{  
    // P. Ackerman's code goes here...  
}