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

接續上篇 Attribute 的介紹，本文將再介紹一些伺服器控制項常用的 Attribute。

 

六、ToolboxDataAttribute 類別

作用：指定當自訂控制項從工具箱拖曳到頁面時，為此自訂控制項產生的預設標記。
當我們新增一個伺服器控制項，它就會預設在控制項類別套用 ToolboxDataAttribute，定義在控制項在 aspx 程式碼中的標記。

<ToolboxData("<{0}:TBButton runat=server ></{0}:TBButton>")> _

Public Class TBButton

    Inherits System.Web.UI.WebControls.Button

End Class

 

 

七、DefaultPropertyAttribute 類別

作用：指定類別的預設屬性。
下面的範例中，MyTextbox 類別套用 DefaultPropertyAttribute，設定 Text 屬性為預設屬性。

<DefaultProperty("Text")> _

Public Class MyTextbox

    Inherits WebControl

    Public Property Text() As String

        Get

            Return CType(Me.ViewState("Text"), String)

        End Get

        Set(ByVal value As String)

            Me.ViewState("Text") = value

        End Set

    End Property

End Class

 

八、DefaultEventAttribute 類別

作用：指定控制項的預設事件。
下面的範例中，MyTextbox 類別套用 DefaultEventAttribute，設定 TextChanged 為預設屬性。

<DefaultEvent("TextChanged")> _

Public Class MyTextbox

    Inherits WebControl

    ''' <summary>

    ''' TextChanged 事件。

    ''' </summary>

    Public Event TextChanged As EventHandler

End Class

 

當設計階段在頁面上的 MyTextbox 控制項點二下時，就會產生預設事件的處理函式。

    Protected Sub MyTextbox1_TextChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyTextbox3.TextChanged

    End Sub

 

九、LocalizableAttribute 類別

作用：指定屬性是否應該當地語系化。
當屬性套用設為為 true 的 LocalizableAttribute 時，其屬性值會儲存在資源檔中，未來不需修改程式碼就可以將這些資源檔當地語系化。

        <Localizable(True)> _

        Public Property Text() As String

            Get

                Return CType(Me.ViewState("Text"), String)

            End Get

            Set(ByVal value As String)

                Me.ViewState("Text") = value

            End Set

        End Property

 

 

十、DesignerAttribute 類別

作用：設定控制項在設計階段服務的類別。
指定一個設計階段的服務類別，來管理控制項在設計階段的行為，例如控制項的設計階段外觀、智能標籤內容。例如下面範例的 TBGridView 控制項就定義了 TBGridViewDesigner 來實作設計階段的行為，未來的章節中也會介紹如何實作控制項的 Designer。

    < Designer(GetType(TBGridViewDesigner)) > _

    Public Class TBGridView

        Inherits GridView

    End Class

 

十一、EditorAttribute 類別

作用：指定在屬性視窗中編輯屬性值的編輯器。
例如 ListBox 控制項的 Items 屬性，在屬性視窗編輯 Items 屬性時，會彈出 Items 集合屬性的編輯器。以下範例就是定義 Items 屬性的編輯器類別為 TBListItemsCollectionEditor，未來的章節中也會介紹如何實作屬性的 Editor。

        <Editor(GetType(TBListItemsCollectionEditor), GetType(System.Drawing.Design.UITypeEditor))> _

        Public Overrides ReadOnly Property Items() As ListItemCollection

 

 

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