用 ASP.NET 2.0 打造一個 Web 自訂伺服器控制項,絕對不是輕鬆的事。你得同時玩得轉 CSS 樣式表、客戶端腳本、.NET 開發語言、控制項開發技術,甚至 Ajax。好消息是,它雖然繁瑣,卻不難到無法掌握——一切都要從頭學起。本文先把最基礎的三件事講清楚:控制項是什麼、有哪些類型、生命週期怎麼走。
一、什麼是 Web 伺服器控制項
在 ASP.NET 2.0 中,Web 伺服器控制項是在伺服器上執行程式邏輯的元件。它可能產生使用者介面,也可能完全不產生。每個控制項都對外暴露一些成員——屬性、事件、方法——供開發人員呼叫。
控制項通常被放在 ASP.NET 頁面裡。頁面執行時,.NET 執行引擎依控制項的成員與邏輯完成對應功能,例如在客戶端呈現介面;使用者與它互動、頁面被提交時,控制項在伺服器端引發事件,由事件處理程式接手。控制項是 WebForm 開發模型的核心元素,透過它把開發抽象化,Web 應用的效率因此提高不少。
那什麼時候該自己寫控制項?三種情況:
- 現有控制項大致合用,但缺了某些特定功能——從它派生並改寫屬性、方法或事件即可。
- 需要把兩個以上現有控制項的功能合起來,例如包一個「按鈕 + 文字框」的複合控制項。
- 現有控制項或其組合都不滿足需求——那就從基類派生,自己造一個。
二、控制項的三種類型
HTML 伺服器控制項
派生自 System.Web.UI.HtmlControls,由普通 HTML 控制項轉換而來,輸出的 HTML 基本與原本一致。預設情況下伺服器端難以操作頁面上的普通 HTML 控制項,轉換之後就能輕鬆用程式控制。轉換只要兩步:加上 runat="server" 屬性,並設定 ID。轉換後,相關屬性、事件、方法都會映射進來。
它的重要特點有:可用面向物件方式在伺服器端操作;自動維護檢視狀態,往返期間使用者輸入的值不會丟;可與驗證控制項互動;允許自訂屬性,頁框架會讀取並呈現而不影響其他功能。
ASP.NET 標準伺服器控制項
定義在 System.Web.UI.WebControls 中,內建於框架、預先定義,並不與 HTML 控制項一對一對應,抽象層次更高、功能更豐富。2.0 相比 1.x 新增了五十多個。依功能可分六類:
- 標準控制項:TextBox、Button、Panel 等傳統 Web 表單控制項,屬性事件方法都標準化。
- 資料控制項:分資料來源控制項(SqlDataSource、AccessDataSource、XmlDataSource、SiteMapDataSource、ObjectDataSource)與資料繫結控制項(Repeater、DataList、GridView、DetailsView、FormView)。前者負責連線與執行查詢,後者負責顯示與編輯刪除介面。在 VS2005 設計期的支援下,甚至可以不寫一行程式就完成。
- 驗證控制項:RequiredFieldValidator、RangeValidator、RegularExpressionValidator、CompareValidator 等,附加到輸入控制項上檢查使用者輸入。
- 站點導航控制項:Menu、SiteMapPath、TreeView,搭配導覽資料呈現層級結構。
- WebParts 控制項:WebPartManager、WebPartZone、EditorZone、CatalogZone、PageCatalogPart、AppearanceEditorPart 等,用來打造高度個人化的入口網站。
- 登入控制項:LoginView、Login、CreateUserWizard、LoginStatus 等,快速實作登入、密碼重設、註冊新用戶。
自訂伺服器控制項
派生自 System.Web.UI.Control 或 System.Web.UI.WebControls,UI、功能、屬性、方法、事件全部由開發人員定義——這正是它與標準控制項的本質差別。常見有四種:複合控制項(包兩個以上既有控制項,複用子控制項的呈現與事件處理)、驗證控制項、模板控制項(本身不提供 UI,由頁面開發人員透過內嵌模板自訂)、資料繫結控制項。
它的優點是彈性大、可用 Style 屬性定義樣式、能在標準控制項基礎上擴充甚至組合成複合控制項、部署容易(把編譯好的 DLL 丟進 bin 即可即插即用);缺點也很明確:需要跨多種技術,且耗時耗力。
三、生命週期:十一個階段
生命週期是控制項開發最重要的概念。初學者不必一開始就鑽到最深,但至少要對各階段有概念,並特別留意「狀態何時被保存、何時被還原」這條主線。
- 初始化:頁框架引發 Init 事件並呼叫 OnInit(),你可以在這裡放初始化邏輯;接著呼叫 TrackViewState 開始追蹤檢視狀態(多數情況基類實作已足夠,只有定義複雜屬性時才需改寫)。
- 載入檢視狀態:發生在回傳過程中而非初始請求。頁框架自動還原 ViewState 字典;若你需要自訂狀態管理或有無法存進 ViewState 的型別,改寫 LoadViewState。
- 處理回傳資料:實作 IPostBackDataHandler 的 LoadPostData(),控制項才能檢查客戶端送回的表單資料。
- 載入:此時控制項樹已建立初始化、狀態已還原、表單已反映客戶端資料。改寫 OnLoad() 放每個請求共通的邏輯。
- 發送回傳變更通知:僅用於回傳過程。LoadPostData() 回傳 true 代表狀態因回傳而改變,頁框架對這些控制項呼叫 RaisePostDataChangedEvent()。
- 處理回傳事件:實作 IPostBackEventHandler 的 RaisePostBackEvent(),把客戶端事件映射到伺服器端事件。
- 預呈現:改寫 OnPreRender()。注意:在這裡改的狀態能保存,等到呈現階段再改就會丟失。
- 保存狀態:自動進行;若需自訂或要存 ViewState 存不了的型別,改寫 SaveViewState()。
- 呈現:向 HTTP 輸出流寫入標記文字,改寫 Render() 自訂輸出。
- 處置:改寫 Dispose() 釋放昂貴資源,例如資料庫連線。
- 卸載:與處置階段類似,但清除工作通常在 Dispose() 中完成,而非處理 Unload 事件。
把這十一個階段與「何時能拿到什麼資料」對應起來記,比死背順序有用得多。控制項在伺服器控制項體系裡舉足輕重,是構建 Web 應用最關鍵的組成元素;基礎打牢了,寫出好控制項才有指望。