# 特性（Attribute）入門（一）

By sadaf alvi 翻譯：cppbug (itwizard@163.com)

緒論

特性（Attributes）是一種嶄新的聲明性信息。我們不僅可以通過(guò)特性來(lái)定義設(shè)計(jì)層面的信息（例如help file, URL for documentation）以及運(yùn)行時(shí)（run-time）信息（例如使XML與class相聯(lián)系），而且我們還可以利用特性建立自描述（self-describing）組件。在這篇教程中，我們將會(huì)看到如何建立和添加特性到各種程序?qū)嶓w以及如何在運(yùn)行時(shí)環(huán)境中獲取特性信息。



定義

正如MSDN中所描述的那樣-----

“特性是被指定給某一聲明的一則附加的聲明性信息。”



使用預(yù)定義（Pre-defined）特性

在C#中，有一個(gè)小的預(yù)定義特性集合。在學(xué)習(xí)如何建立我們自己的定制特性（custom attributes）之前，我們先來(lái)看看在我們的代碼中如何使用預(yù)定義特性。



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( );
}
}
我們先來(lái)看一下上面這個(gè)例子，在這個(gè)例子中我們使用了Obsolete特性，它標(biāo)記了一個(gè)不應(yīng)該再被使用的程序?qū)嶓w。第一個(gè)參數(shù)是一個(gè)字符串，它解釋了為什么該實(shí)體是過(guò)時(shí)的以及應(yīng)該用什么實(shí)體來(lái)代替它。實(shí)際上，你可以在這里寫(xiě)任何文本。第二個(gè)參數(shù)告訴編譯器應(yīng)該把使用這個(gè)過(guò)時(shí)的程序?qū)嶓w當(dāng)作一種錯(cuò)誤。它的默認(rèn)值是false，也就是說(shuō)編譯器對(duì)此會(huì)產(chǎn)生一個(gè)警告。

當(dāng)我們嘗試編譯上面這段程序的時(shí)候，我們將會(huì)得到一個(gè)錯(cuò)誤：

AnyClass.Old()' is obsolete: 'Don't use Old method, use New method'


開(kāi)發(fā)定制特性（custom attributes）

現(xiàn)在讓我們來(lái)看看如何開(kāi)發(fā)我們自己的特性。

首先我們要從System.Attribute派生出我們自己的特性類（一個(gè)從System.Attribute抽象類繼承而來(lái)的類，不管是直接還是間接繼承，都會(huì)成為一個(gè)特性類。特性類的聲明定義了一種可以被放置在聲明之上新的特性）。

using System;
public class HelpAttribute : Attribute
{
}
不管你是否相信，我們已經(jīng)建立了一個(gè)定制特性，現(xiàn)在我們可以用它來(lái)裝飾現(xiàn)有的類就好像上面我們使用Obsolete attribute一樣。

[Help()]
public class AnyClass
{
}
注意：對(duì)一個(gè)特性類名使用Attribute后綴是一個(gè)慣例。然而，當(dāng)我們把特性添加到一個(gè)程序?qū)嶓w，是否包括Attribute后綴是我們的自由。編譯器會(huì)首先在System.Attribute的派生類中查找被添加的特性類。如果沒(méi)有找到，那么編譯器會(huì)添加Attribute后綴繼續(xù)查找。



到目前為止，這個(gè)特性還沒(méi)有起到什么作用。下面我們來(lái)添加些東西給它使它更有用些。

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特性類添加了一個(gè)屬性并且在后續(xù)的部分中我們會(huì)在運(yùn)行時(shí)環(huán)境中查尋它。







（未完待續(xù)）