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

來源:互聯網
上載者:User
asp.net|設計 自訂控制項(custom control)入門

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

為了能夠參與到網頁架構執行,需要滿足IComponent, IDisposable, IParserAccessor, IdataBindingsAccessor等介面。所以架構提供System.Web.Control類供控制項開發人員繼承。

IComponent 提供組件所需的準系統,介面實現為:

{

ISite Site {get; set;}//提供網站介面,組件可以通過此介面訪問容器

event EventHandler Disposed; //事件

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

IDisposable 介面實現組件自身資源釋放(Icomponent實際上繼承自IDisposable )

IParserAccessor 該介面規定AddParsedSubObject(object obj)方法用於通知伺服器控制項已分析元素(XML 或 HTML)。分析元素時,元素被識別為實現該介面的伺服器控制項的子級。這些元素將被轉換為對象。實現該介面時,所建立的控制項在被通知已分析元素後立即定義要發生的處理。

IDataBindingsAccessor 介面允許在設計時訪問控制項的資料繫結運算式集合。

{

DataBindingCollection DataBindings {get;}// 指示控制項的所有資料繫結的集合。此屬性為唯讀。

bool HasDataBindings {get;} //返回控制項是否包含任何資料繫結邏輯。

}



繼承自Control的WebControl類為表現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 導致Tracing Service器控制項的檢視狀態的更改,以便這些更改可以儲存到伺服器控制項的 StateBag 對象中。通過 Control.ViewState 屬性可訪問此對象。





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




相關文章

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.