[ASP.NET 控制項實作 Day8] 控制項常用 Attribute 介紹(1)

Property 與 Attribute 二個術語一般都是翻譯成「屬性」，例如類別的屬性，是使用英文的 Property，而 HTML/XML 的元素屬性，使用的英文則是 Attribute。在 .NET 中 Property 與 Attribute 的意義及用法不同，不過微軟線上檔案也將它翻譯為「屬性」，這可能讓人發生困擾及誤解；筆者比較喜歡的方式就是 Property 是屬性，Attribute 就維持原文。在 .NET 中類別或屬性上可以套用上不同的 Attribute，使類別或屬性具有不同的特性，本文將介紹一些在伺服器控制項常使用到的 Attribute。

一、DescriptionAttribute 類別

作用：指定控制項或屬性的描述。
當 DescriptionAttribute 套用至控制項的類別時，設定的描述內容就會出現在工具箱中控制項的提示。

 

<Description("按鈕控制項")> _

Public Class TBButton

    Inherits System.Web.UI.WebControls.Button

End Class

 

 

當 DescriptionAttribute 套用至控制項的屬性時，在屬性視窗下面就會出現設定的屬性描述內容。

        <Description("詢問訊息")> _

        Public Property ConfirmMessage() As String

 

 

二、DefaultValueAttribute 類別

作用：指定屬性的預設值。
使用 DefaultValueAttribute 設定屬性的預設值，若設定的屬性值與預設值相同時，此屬性值就不會出現在 aspx 程式碼中；筆者強烈建議屬性一定套用 DefaultValueAttribute，一來在 aspx 中的程式碼會比較少，另外一個重點是若因為某些因素需要修改屬性的預設值時，所有已開發頁面的控制項屬性值會一併變更；因為當初屬性值是預設值，沒有被寫入 aspx 程式碼中，所以一但控制項的屬性預設值變更，頁面已布屬的控制項的屬性值就會全面適用。

        Private FConfirmMessage As String = String.Empty

        <DefaultValue("")> _

        Public Property ConfirmMessage() As String

            Get

                Return FConfirmMessage

            End Get

            Set(ByVal value As String)

                FConfirmMessage = value

            End Set

        End Property

 

 

三、CategoryAttribute 類別

作用：指定屬性或事件的分類名稱，當屬性視窗設定為 [分類] 模式時，以群組方式來顯示內容或事件。
例如設定 ConfirmMessage 屬性在 "Behavior" 分類，則 ConfirmMessage 屬性會被歸類到「行為」分類。

        <Category("Behavior")> _

        Public Property ConfirmMessage() As String

 

 

四、BindableAttribute 類別

作用：指定成員是否通常使用於繫結。
在資料繫結設定視窗中中，指定屬性是否預設會出現在屬性清單中。

        <Bindable(True)> _

        Public Property ConfirmMessage() As String

 

 

 

五、BrowsableAttribute 類別

作用：指定屬性或事件是否應該在 [屬性] 視窗中顯示。
若屬性在設計階段無須修正，可以設定該屬性不要出現在屬性視窗中，此時可以在屬性上套用 Browsable(False) 即可。

        <Browsable(False)> _

        Public Property ConfirmMessage() As String

 

備忘：本文同步發佈於「第一屆iT邦幫忙鐵人賽」，如果你覺得這篇文章對您有協助，記得連上去推鑒此文增加人氣 ^^
http://ithelp.ithome.com.tw/question/10012016