C#自定義特性(Attribute)詳解
在前面介紹的代碼中有使用特性,這些特性都是Microsoft定義好的,作為.NET Framework類庫的一部分,許多特性都得到了C#編譯器的支持。
.NET Frmework也允許定義自己的特性。自定義特性允許把自定義元數(shù)據(jù)與程序元素關聯(lián)起來。這些元數(shù)據(jù)是在編譯過程中創(chuàng)建的,并嵌入到程序集中。這些特性不會影響編譯過程,因為編譯器不能識別它們,但這些特性在應用于程序元素時,可以在編譯好的程序集中用作元數(shù)據(jù)。這些元數(shù)據(jù)在文檔說明中很有用。使自定義特性起很大作用的是反射(http://www.dbjr.com.cn/article/244259.htm)技術,代碼可以讀取這些元數(shù)據(jù),使用它們在運行期間作決策。
編寫自定義特性
[FieldName("Social")] public string SocialNumber { ... }
當C#編譯器發(fā)現(xiàn)SocialNumber屬性應用了一個FieldName特性時,首先會把字符串Attribute追加到FieldName這個名稱后面,形成一個組合名稱FieldNameAttribute,然后在其搜索路徑的所有名稱空間(即在using語句中提及的名稱空間)中搜索FieldNameAttribute類。但如果該特性的名稱以字符串Attribute結(jié)尾,編譯器就不會把這個字符串加到組合名稱中。
因此上面的代碼等價于:
[FieldNameAttribute("Social")] public string SocialNumber { ... }
1.AttributeUsage特性
自定義的特性類需要直接或間接派生自System.Attribute。這個類還應包含控制用法的信息:
- *特性可以應用到哪些類型的程序元素上(類,結(jié)構(gòu),屬性和方法等)
- *特性是否可以多次應用到同一個程序元素上
- *特性在應用到類或接口上時,是否由派生類和接口繼承
- *這個特性有哪些必選和可選參數(shù)
如果編譯器找不到對應的特性類,或者找到一個這樣的特性類,但使用特性的方式與特性類中的信息不匹配,編譯器就會產(chǎn)生一個編譯錯誤。
定義FieldNameAttribute特性
[AttributeUsage(AttributeTargets.Property, AllowMultiple=false, Inherited=false)] public class FieldNameAttribute:Attribute { private string name; public FieldNameAttribute(string name) { this.name = name; } }
特性類FieldNameAttribute本身用了一個特性System.AttributeUsage來標記。這是Microsoft定義的一個特性,C#編譯器為它提供了特殊的支持。AttributeUsage主要用于標識自定義特性可以應用到哪些類型的程序元素上。這些信息由它的第一個參數(shù)AttributeTargets給出,該參數(shù)是必選的,其類型是枚舉類型AttributeTargets。上面的例子,指定FieldNameAttribute特性只能應用到屬性上。
AttributeTargets枚舉的成員如下:
上面列出了可以應用該特性的所有程序元素。在把特性應用到程序元素上時,應把特性放在元素前面的方括號中:
[FieldName("Social")] public string SocialNumber { ... }
但在應用到Assembly和Module時,特性可以應用到整個程序集或模塊中,而不是應用到代碼中的一個元素上,在這種情況下,這個特性可以放在源代碼的任何地方,但需要使用關鍵字Assembly和Module作為前綴:
[assembly:FieldName("Social")] [module:FieldName("Social")]
在指定自定義特性的有效目標元素時,可以使用OR運算符(|)把這些值組合起來:
[AttributeUsage(AttributeTargets.Property |AttributeTargets.Field, AllowMultiple=false, Inherited=false)] public class FieldNameAttribute:Attribute { private string name; public FieldNameAttribute(string name) { this.name = name; } }
也可以使用AttributeTargets.All指定自定義特性可以應用到所有類型的程序元素上。
AttributeUsage特性還包含另外兩個參數(shù):AllowMultiple和Inherited。它們用不同的語法來指定:參數(shù)名 = 參數(shù)值,而不是只給出這些參數(shù)的值。這些參數(shù)是可選的。
- AllowMultiple參數(shù)表示一個特性是否可以多次應用到同一項上。
- Inherited參數(shù)表示應用到類或接口上的特性是否自動應用到所以派生的類或接口上。如果特性應用到方法或?qū)傩陨希妥詣討玫剿鼈兊闹貙懓姹旧稀?/li>
2.指定特性參數(shù)
[FieldName("Social")] public string SocialNumber { ... }
編譯器會檢查傳遞給特性的參數(shù)(在本例中,是一個字符串),并產(chǎn)兆該特性類中帶這些參數(shù)的構(gòu)造函數(shù)。如果找到匹配的構(gòu)造函數(shù),編譯器就會把指定的元數(shù)據(jù)傳遞給程序集。如果找不到,就會生成一個編譯錯誤。反射()會從程序集中讀取元數(shù)據(jù),并實例化它們表示的特性類。因此,編譯器需要確保存在這樣的構(gòu)造函數(shù),才能在運行期間實例化指定的特性。
3.特性的可選參數(shù)
在AttributeUsage特性中,使用參數(shù)名 = 參數(shù)值語法把可選參數(shù)添加到特性中。這種語法指定可選參數(shù)的名稱和值,它通過特性類中的公共屬性或字段起作用:
[AttributeUsage(AttributeTargets.Property, AllowMultiple=false, Inherited=false)] public class FieldNameAttribute:Attribute { private string name; public FieldNameAttribute(string name) { this.name = name; } public string Comment { get;set; } } [FieldName("Social",Comment="可選參數(shù)值")] public string SocialNumber { ... }
到此這篇關于C#自定義特性(Attribute)的文章就介紹到這了。希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
C#多態(tài)的三種實現(xiàn)方式(小結(jié))
這篇文章主要介紹了C#多態(tài)的三種實現(xiàn)方式(小結(jié)),文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2021-03-03C#連接SQL數(shù)據(jù)庫和查詢數(shù)據(jù)功能的操作技巧
本文給大家分享C#連接SQL數(shù)據(jù)庫和查詢數(shù)據(jù)功能的操作技巧,本文通過圖文并茂的形式給大家介紹的非常詳細,需要的朋友參考下吧2021-05-05在Winform程序中使用Spire.Pdf實現(xiàn)頁面添加印章功能的實現(xiàn)
這篇文章主要介紹了在Winform程序中使用Spire.Pdf實現(xiàn)頁面添加印章功能的實現(xiàn),本文通過實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-09-09