ASP.NET組件設計Step by Step(3)

 

自定義控件(custom control)入門<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

在服務器端中執行程序邏輯的組件,是asp.net 應用程序的基本構造塊。爲了能夠在asp.net環境執行,必須滿足一定條件。

        爲了能夠參與到網頁框架執行,需要滿足IComponent, IDisposable, IParserAccessor,   IdataBindingsAccessor等接口。所以框架提供System.Web.Control類供控件開發者繼承。

IComponent     提供組件所需的基本功能,接口實現爲:

        {

        ISite Site {get; set;}//提供站點接口,組件可以通過此接口訪問容器

        event EventHandler Disposed;        //事件

} 如果實現了此接口,就成爲可設計組件,可加入到可視化設計器工具箱,能夠脫放到頁面(Isite接口)中,屬性瀏覽器中顯示屬性。

IDisposable  接口實現組件自身資源釋放(Icomponent實際上繼承自IDisposable 

IParserAccessor 該接口規定AddParsedSubObjectobject obj)方法用於通知服務器控件已分析元素(XML HTML)。分析元素時,元素被識別爲實現該接口的服務器控件的子級。這些元素將被轉換爲對象。實現該接口時,所創建的控件在被通知已分析元素後立即定義要發生的處理。

IDataBindingsAccessor 接口允許在設計時訪問控件的數據綁定表達式集合。

{

       DataBindingCollection DataBindings {get;}// 指示控件的所有數據綁定的集合。此屬性爲只讀。

bool HasDataBindings {get;} //返回控件是否包含任何數據綁定邏輯。

}

 

       繼承自ControlWebControl類爲表現HTML(畢竟最後用戶看到的是HTML)而在Control類中加入了一些新的功能,如樣式、字體、背景、前景。。。

 

Control類的定義:

       公共屬性:

ClientID 獲取由 ASP.NET 生成的服務器控件標識符。

Controls 獲取 ControlCollection 對象,該對象表示 UI 層次結構中指定服務器控件的子控件。

EnableViewState 獲取或設置一個值,該值指示服務器控件是否向發出請求的客戶端保持自己的視圖狀態以及它所包含的任何子控件的視圖狀態。

ID 獲取或設置分配給服務器控件的編程標識符。

NamingContainer 獲取對服務器控件的命名容器的引用,此引用創建唯一的命名空間,以區分具有相同 Control.ID 屬性值的服務器控件。

Page 獲取對包含服務器控件的 Page 實例的引用。

Parent 獲取對頁 UI 層次結構中服務器控件的父控件的引用。

Site 獲取有關服務器控件所屬 Web 站點的信息(原文自MSDN,但是我認爲不對,應該是指組件的“容器”站點,並非 web site)。

TemplateSourceDirectory 獲取包含當前服務器控件的 Page UserControl 的虛擬目錄。

UniqueID 獲取服務器控件的唯一的、以分層形式限定的標識符。

Visible 獲取或設置一個值,該值指示服務器控件是否作爲 UI 呈現在頁上。

 

公共方法

DataBind 將數據源綁定到被調用的服務器控件及其所有子控件。

Dispose 使服務器控件得以在從內存中釋放之前執行最後的清理操作。

Equals(從 Object 繼承) 已重載。確定兩個 Object 實例是否相等。

FindControl 已重載。在當前的命名容器中搜索指定的服務器控件。

GetHashCode(從 Object 繼承) 用作特定類型的哈希函數,適合在哈希算法和數據結構(如哈希表)中使用。

GetType(從 Object 繼承) 獲取當前實例的 Type

HasControls 確定服務器控件是否包含任何子控件。

RenderControl 將服務器控件的內容輸出到所提供的 HtmlTextWriter 對象中;如果已啓用跟蹤功能,則存儲有關控件的跟蹤信息。

ResolveUrl 根據傳遞給 TemplateSourceDirectory 屬性的值,將相對 URL 解析爲絕對 URL

ToString(從 Object 繼承) 返回表示當前 Object String

 

       公共事件

DataBinding 當服務器控件綁定到數據源時發生。

Disposed 當從內存釋放服務器控件時發生,這是請求 ASP.NET 頁時服務器控件生存期的最後階段。

Init 當服務器控件初始化時發生;初始化是控件生存期的第一步。服務器控件應執行任何創建和設置實例所需的初始化步驟。在該事件內無法使用視圖狀態信息;它尚未填充。在該事件的生存期內不應訪問其他服務器控件,不論它是此控件的子級還是父級。不一定會創建其他服務器控件,也不一定能夠訪問它們。

Load 當服務器控件加載到 Page 對象中時發生。通知服務器控件執行任何設置爲在每次頁請求時發生的處理步驟。開發者可以訪問視圖狀態信息並利用該事件形成 POST 數據。還可以訪問頁控件層次結構內的其他服務器控件。

PreRender 當服務器控件將要呈現給其包含的 Page 對象時發生。使用該事件在服務器控件呈現給頁的輸出之前執行任何更新。在該事件的生存期內可以保存服務器控件視圖狀態的任何更改。不保存呈現階段內所做的同樣更改。

Unload 當服務器控件從內存中卸載時發生。

 

              受保護的屬性和方法有:

              保護的屬性

ChildControlsCreated 獲取一個值,該值指示是否已創建服務器控件的子控件。

Context 爲當前 Web 請求獲取與服務器控件關聯的 HttpContext 對象。

Events 獲取控件的事件處理程序委託列表。此屬性爲只讀。

HasChildViewState 獲取一個值,該值指示當前服務器控件的子控件是否具有任何已保存的視圖狀態設置。

IsTrackingViewState 獲取一個值,該值指示服務器控件是否將更改保存到其視圖狀態。

ViewState 獲取狀態信息的字典,這些信息使您可以在同一頁的多個請求間保存和還原服務器控件的視圖狀態。

ViewStateIgnoresCase 獲取一個值,該值指示 StateBag 對象是否不區分大小寫。

受保護的方法

AddParsedSubObject 通知服務器控件某個元素(XML HTML)已經過語法分析,並將該元素添加到服務器控件的 ControlCollection 對象。

ClearChildViewState 刪除服務器控件的所有子控件的視圖狀態信息。

CreateChildControls 通知使用基於合成的實現的服務器控件創建它們包含的任何子控件,以便爲回發或呈現做準備。

CreateControlCollection 創建一個新的 ControlCollection 對象來保存服務器控件的子控件(包括文本控件和服務器控件)。

EnsureChildControls 確定服務器控件是否包含子控件。如果不包含,則創建子控件。

Finalize(從 Object 繼承) 已重寫。允許 Object 在“垃圾回收”回收 Object 之前嘗試釋放資源並執行其他清理操作。

IsLiteralContent 確定服務器控件是否只包含文字內容。Asp.net頁面中普通的html標籤被asp.net編譯爲一個 LiteralContent控件(意味着輕型控件)。

LoadViewState SaveViewState 方法保存的上一個頁請求還原視圖狀態信息。

MapPathSecure 如果請求服務器控件有足夠的安全權限讀取映射結果,檢索相對於源文件的映射物理文件路徑。

MemberwiseClone(從 Object 繼承) 創建當前 Object 的淺表副本。

OnBubbleEvent 確定服務器控件的事件是否沿頁的 UI 服務器控件層次結構向上傳遞。

OnDataBinding 引發 DataBinding 事件。

OnInit 引發 Init 事件。

OnLoad 引發 Load 事件。

OnPreRender 引發 PreRender 事件。

OnUnload 引發 Unload 事件。 注意   在服務器控件生存期的此階段,服務器控件應執行所有最後的清理操作,例如關閉文件、關閉數據庫連接和丟棄對象。

RaiseBubbleEvent 將所有事件源及其信息分配給控件的父級。

Render 將服務器控件內容發送到提供的 HtmlTextWriter 對象,此對象編寫將在客戶端呈現的內容。

RenderChildren 將服務器控件子級的內容輸出到提供的 HtmlTextWriter 對象,此對象編寫將在客戶端呈現的內容。

SaveViewState 保存自頁回發到服務器後發生的任何服務器控件視圖狀態更改。

TrackViewState 導致跟蹤服務器控件的視圖狀態的更改,以便這些更改可以存儲到服務器控件的 StateBag 對象中。通過 Control.ViewState 屬性可訪問此對象。

 

 

瞭解了Control這個“基石”,我們可以瞭解到,編寫服務器組件就是在此基石上建造,同時我們可以調用的方法、數據,可以截獲的事件都列出,以上數據成員是我們編寫服務器控件的“輸入數據”(當然還可以有其他輸入數據,但是主要數據在此);以上方法是幫助我們操控控件以及控件同外部交互,事件爲我們“感知”外部交互提供時機;另外,服務器控件也需要被容器調用相關方法(譬如render),我們可以重寫這些方法,修改Control的缺省GUI表現。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章