特性(attribute)是被指定給某一聲明的一則附加的聲明性信息。 在C#中,有一個小的預定義特性集合。在學習如何建立我們自己的定製特性(custom attributes)之前,我們先來看看在我們的代碼中如何使用預定義特性。 1 using System; 2 public class AnyC ...
特性(attribute)是被指定給某一聲明的一則附加的聲明性信息。
在C#中,有一個小的預定義特性集合。在學習如何建立我們自己的定製特性(custom attributes)之前,我們先來看看在我們的代碼中如何使用預定義特性。
1 using System; 2 public class AnyClass 3 { 4 [Obsolete("Don't use Old method, use New method", true)] 5 static void Old( ) { } 6 static void New( ) { } 7 public static void Main( ) 8 { 9 Old( ); 10 } 11 }
我們先來看一下上面這個例子,在這個例子中我們使用了Obsolete特性,它標記了一個不應該再被使用的程式實體。第一個參數是一個字元串,它解釋了為什麼該實體是過時的以及應該用什麼實體來代替它。實際上,你可以在這裡寫任何文本。第二個參數告訴編譯器應該把使用這個過時的程式實體當作一種錯誤。它的預設值是false,也就是說編譯器對此會產生一個警告。
當我們嘗試編譯上面這段程式的時候,我們將會得到一個錯誤:
AnyClass.Old()' is obsolete: 'Don't use Old method, use New method'
開發定製特性(custom attributes)
現在讓我們來看看如何開發我們自己的特性。
首先我們要從System.Attribute派生出我們自己的特性類(一個從System.Attribute抽象類繼承而來的類,不管是直接還是間接繼承,都會成為一個特性類。特性類的聲明定義了一種可以被放置在聲明之上新的特性)。
1 using System; 2 public class HelpAttribute : Attribute 3 { 4 }
不管你是否相信,我們已經建立了一個定製特性,現在我們可以用它來裝飾現有的類就好像上面我們使用Obsolete attribute一樣。
1 [Help()] 2 public class AnyClass 3 { 4 }
註意:對一個特性類名使用Attribute尾碼是一個慣例。然而,當我們把特性添加到一個程式實體,是否包括 Attribute尾碼是我們的自由。編譯器會首先在System.Attribute的派生類中查找被添加的特性類。如果沒有找到,那麼編譯器會添加 Attribute尾碼繼續查找。
到目前為止,這個特性還沒有起到什麼作用。下麵我們來添加些東西給它使它更有用些。
1 using System; 2 public class HelpAttribute : Attribute 3 { 4 public HelpAttribute(String Descrition_in) 5 { 6 this.description = Description_in; 7 } 8 protected String description; 9 public String Description 10 { 11 get 12 { 13 return this.description; 14 } 15 } 16 } 17 [Help("this is a do-nothing class")] 18 public class AnyClass 19 { 20 }
在上面的例子中,我們給HelpAttribute特性類添加了一個屬性並且在後續的部分中我們會在運行時環境中查尋它。
定義或控制特性的使用
AttributeUsage類是另外一個預定義特性類,它幫助我們控制我們自己的定製特性的使用。它描述了一個定製特性如和被使用。
AttributeUsage有三個屬性,我們可以把它放置在定製屬性前面。第一個屬性是:
ValidOn
通過這個屬性,我們能夠定義定製特性應該在何種程式實體前放置。一個屬性可以被放置的所有程式實體在AttributeTargets enumerator中列出。通過OR操作我們可以把若幹個AttributeTargets值組合起來。
AllowMultiple
這個屬性標記了我們的定製特性能否被重覆放置在同一個程式實體前多次。
Inherited
我們可以使用這個屬性來控制定製特性的繼承規則。它標記了我們的特性能否被繼承。
下麵讓我們來做一些實際的東西。我們將會在剛纔的Help特性前放置AttributeUsage特性以期待在它的幫助下控制Help特性的使用。
1 using System; 2 [AttributeUsage(AttributeTargets.Class), AllowMultiple = false, 3 Inherited = false ] 4 public class HelpAttribute : Attribute 5 { 6 public HelpAttribute(String Description_in) 7 { 8 this.description = Description_in; 9 } 10 protected String description; 11 public String Description 12 { 13 get 14 { 15 return this.description; 16 } 17 } 18 }
先讓我們來看一下AttributeTargets.Class。它規定了Help特性只能被放在class的前面。這也就意味著下麵的代碼將會產生錯誤:
1 [Help("this is a do-nothing class")] 2 public class AnyClass 3 { 4 [Help("this is a do-nothing method")] //error 5 public void AnyMethod() 6 { 7 } 8 }
編譯器報告錯誤如下:
AnyClass.cs: Attribute 'Help' is not valid on this declaration type.
It is valid on 'class' declarations only.
我們可以使用AttributeTargets.All來允許Help特性被放置在任何程式實體前。可能的值是:
Assembly,Module,Class,Struct,Enum,Constructor,Method,Property,Field,Event,Interface,Parameter,Delegate
All = Assembly | Module | Class | Struct | Enum | Constructor | Method | Property | Field | Event | Interface | Parameter | Delegate
ClassMembers = Class | Struct | Enum | Constructor | Method | Property | Field | Event | Delegate | Interface
下麵考慮一下AllowMultiple = false。它規定了特性不能被重覆放置多次。
1 [Help("this is a do-nothing class")] 2 [Help("it contains a do-nothing method")] 3 public class AnyClass 4 { 5 [Help("this is a do-nothing method")] //error 6 public void AnyMethod() 7 { 8 } 9 }
它產生了一個編譯期錯誤。
AnyClass.cs: Duplicate 'Help' attribute
Ok,現在我們來討論一下最後的這個屬性。Inherited, 表明當特性被放置在一個基類上時,它能否被派生類所繼承。
1 [Help("BaseClass")] 2 public class Base 3 { 4 } 5 public class Derive : Base 6 { 7 }
這裡會有四種可能的組合:
1 [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false ] 2 [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = false ] 3 [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = true ] 4 [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = true ]
第一種情況:
如果我們查詢(Query)(稍後我們會看到如何在運行期查詢一個類的特性)Derive類,我們將會發現Help特性並不存在,因為inherited屬性被設置為false。
第二種情況:
和第一種情況相同,因為inherited也被設置為false。
第三種情況:
為瞭解釋第三種和第四種情況,我們先來給派生類添加點代碼:
1 [Help("BaseClass")] 2 public class Base 3 { 4 } 5 [Help("DeriveClass")] 6 public class Derive : Base 7 { 8 }
現在我們來查詢一下Help特性,我們只能得到派生類的屬性,因為inherited被設置為true,但是AllowMultiple卻被設置為false。因此基類的Help特性被派生類Help特性覆蓋了。
第四種情況:
在這裡,我們將會發現派生類既有基類的Help特性,也有自己的Help特性,因為AllowMultiple被設置為true。
定義或控制特性的使用AttributeUsage類是另外一個預定義特性類,它幫助我們控制我們自己的定製特性的使用。它描述了一個定製特性如何被使用。
屬性和特性的區別可以參考一下: http://developer.51cto.com/art/200908/147097.htm
本文來自CSDN博客,轉載請標明出處:http://blog.csdn.net/Foxalien/archive/2009/12/05/4946672.aspx