ASP.NET表單介紹
Form(表單)是asp.net開(kāi)發(fā)中重要的組成部分--沒(méi)有Form就沒(méi)有asp.net Web編程模型。Form不局限于純粹的HTML,但是在asp.net中會(huì)受到一些限制。對(duì)于asp.net頁(yè)面,F(xiàn)orm可以提交自身,并且asp.net模型提供了控件狀態(tài)管理和postback事件。由于asp.net的單一Form模型使得編寫(xiě)asp.net應(yīng)用程序簡(jiǎn)單又便捷.
asp.net中窗體上的限制可能聽(tīng)起來(lái)怪異而武斷,但實(shí)際上跟asp.net模型有直接的作用。然而,有一種實(shí)際情況是asp.net 1.x form 模型所不支持的:在同一個(gè)頁(yè)面擁有多個(gè),互不干涉的form。比如,您不能在某個(gè)頁(yè)面上添加一個(gè)搜索文本框并將結(jié)果提交到另一個(gè)頁(yè)面.
在msdn雜志2003年5月刊上,我寫(xiě)了一個(gè)專(zhuān)欄關(guān)于asp.net 1.x的Form編程(參閱 Cutting Edge: Form-based Programming in asp.net),對(duì)于asp.net 2.0的介紹里, 關(guān)于提交給不同的頁(yè)面這一主題的地址有一些變動(dòng)。本文我將討論asp.net 2.0下的Form編程.
ASP.NET表單·窗體呈現(xiàn)
讓我們探索一下asp.net的窗體世界,去了解窗體(包括控件)是如何實(shí)際呈現(xiàn)的。在asp.net頁(yè)面上,< form>標(biāo)記可以是幾種容器控件像< table>, < div>, 或 < body>的子控件; 然而,在大多數(shù)頁(yè)面中,< form>只是簡(jiǎn)單作為< body>的子節(jié)點(diǎn)。如果一個(gè)非容器控件(比如TextBox)被放置在form標(biāo)記之外,將會(huì)拋出一個(gè)運(yùn)行時(shí)錯(cuò)誤(編譯時(shí)不會(huì)對(duì)此進(jìn)行檢查)。請(qǐng)看如下代碼,節(jié)選自TextBox的 AddAttributesToRender 方法:
- protected override void AddAttributesToRender(HtmlTextWriter writer)
- {
- if (this.Page != null) this.Page.VerifyRenderingInServerForm(this);
- ...
- }
調(diào)用頁(yè)面的VerifyRenderingInServerForm方法將會(huì)處理此工作。(當(dāng)您自己編寫(xiě)自定義服務(wù)器控件時(shí)應(yīng)避免這種行為)
ASP.NET表單·HtmlForm類(lèi)
HtmlForm繼承自HtmlContainerControl,使得窗體具有包含子控件的能力。HtmlForm提供了對(duì)HTML< form>元素在服務(wù)器端的編程訪(fǎng)問(wèn)能力,其properties列表見(jiàn)圖1。從表中可以看到asp.net 1.x 和 asp.net 2.0的變化主要限于幾個(gè)properties。
一個(gè)表單必須擁有唯一的名字,未指定名字時(shí)asp.net會(huì)自動(dòng)分配一個(gè)??梢酝ㄟ^(guò)ID或Name屬性給Form設(shè)置標(biāo)識(shí),同時(shí)設(shè)置時(shí)以ID屬性?xún)?yōu)先。可是有一點(diǎn)要注意,一些編程接口使用Name屬性來(lái)兼容xhtml。在xhtml中,elements通過(guò)ID標(biāo)識(shí)而不是Name,因此通常來(lái)講,最好以ID屬性為準(zhǔn)。
表單的父對(duì)象是一個(gè)具有runat屬性的總?cè)萜骺丶H绻@樣的控件不存在,頁(yè)面對(duì)象被作為父對(duì)象。典型的服務(wù)器端form的容器是標(biāo)記為服務(wù)器端對(duì)象的< table>或< div>。
圖2 列出了HtmlForm類(lèi)中最常用的到一些方法。這些方法繼承于System.Web.UI.Control類(lèi)。注意FindControl方法只搜索form的直接子控件。內(nèi)部容器中的子控件和表單子控件的子控件將不能被找到。
ASP.NET表單·多表單管理
通常來(lái)講,投入單表單模型的懷抱而放棄對(duì)多表單系統(tǒng)的支持并不算是很大的犧牲。盡管一些頁(yè)面如果能使用multiple forms將會(huì)獲得更加致一致和自然的設(shè)計(jì)--至少對(duì)于那些包含有一定邏輯關(guān)系的輸入控件組的表單 例如,一個(gè)頁(yè)面除了要給用戶(hù)提供信息,還需要支持一個(gè)搜索表單或者登錄框表單。
您可以將搜索和登錄功能合并到ad hoc類(lèi)并通過(guò)顯示信息的同一頁(yè)面調(diào)用,然而這并不是構(gòu)造代碼的最佳方法。
如果您正在將老的代碼移植到asp.net, 您可能覺(jué)得將登錄和搜索代碼置于另一個(gè)專(zhuān)門(mén)的頁(yè)面更容易些??墒悄绾尾拍軐⒛切╉?yè)面的數(shù)據(jù)提交到本頁(yè)呢?
在單表單模型里,頁(yè)面總是提交自身而且也沒(méi)有給開(kāi)發(fā)者提供設(shè)置回傳目標(biāo)的鉤子。對(duì)于HTML和ASP編程,表單的Action屬性是單一值,在asp.net的HtmlForm類(lèi)中也不暴露此屬性。單表單模型跟asp.net平臺(tái)整合的太緊密,您要么采用要么放棄——或者,做為一個(gè)附加的選擇就是可以用ASP的方式編寫(xiě)代碼不使用服務(wù)器表單。象下面要講到的,在asp.net 2.0里,可以將數(shù)據(jù)提交到另一個(gè)頁(yè)面,但是這個(gè)特性是通過(guò)一些按鈕控件的新增功能得以實(shí)現(xiàn)的?,F(xiàn)在,我們先看看使用HTML的非服務(wù)器端表單時(shí)有什么棘手問(wèn)題。
在asp.net中,當(dāng)有多個(gè)HtmlForm控件需要呈現(xiàn)時(shí)將會(huì)拋出異常。頁(yè)面中的第一個(gè)HtmlForm控件被呈現(xiàn)后,會(huì)有一個(gè)布爾標(biāo)記被設(shè)為true,此標(biāo)記指示了是否有HtmlForm已被呈現(xiàn),當(dāng)另一個(gè)HtmlForm試圖呈現(xiàn)時(shí),由于此標(biāo)記已經(jīng)被設(shè)置為true因而引發(fā)一個(gè)異常。
如果一個(gè)Web Form中包含了一個(gè)服務(wù)器form和任意數(shù)量的不含有runat屬性的< form>標(biāo)記不會(huì)導(dǎo)致任何錯(cuò)誤。沒(méi)有runat屬性,任何標(biāo)記都成為純粹單一的HTML而直接呈現(xiàn)(見(jiàn)圖3).
此頁(yè)面包含2個(gè)表單,第二個(gè)是沒(méi)有ruan="server"屬性的HTML表單,因此被asp.net完全忽略。提供給瀏覽器的html中合法包含了兩個(gè)< form>元素,它們指向兩個(gè)不同的action URL。
然而從功能上來(lái)講此代碼有一個(gè)大的缺陷:不能使用asp.net編程模型來(lái)檢索客戶(hù)端表單action頁(yè)面上的提交數(shù)據(jù)。當(dāng)編寫(xiě)search.aspx時(shí),對(duì)于客戶(hù)端表單的action頁(yè)面,不能對(duì)頁(yè)面的控件借助視圖狀態(tài)和提交數(shù)據(jù)來(lái)讀取和更新它們的狀態(tài)。(The apparent statefulness of asp.net server controls is obtained by making pages post to themselves)為了知道提交給search.aspx的數(shù)據(jù),您必須采取針對(duì)ASP模型的直接在回傳數(shù)據(jù)中檢索的傳統(tǒng)風(fēng)格:
- protected void Page_Load(object sender, EventArgs e)
- {
- // Use the Request to retrieve posted data
- string textToSearch = Request.Form["Keyword"].ToString();
- ...
- // Use standard asp.net to populate the page UI
- KeywordBeingUsed.Text = textToSearch;
- }
可以使用 HttpRequest 對(duì)象協(xié)議規(guī)范中的集合(Page.Request等同于HttpContext.Current.Request)來(lái)檢索回傳的數(shù)據(jù)——對(duì)于POST方式時(shí)使用Form,GET方式時(shí)使用QueryString,或者想要兼容對(duì)Form、QueryString、 ServerVariables 和 Cookies的訪(fǎng)問(wèn)時(shí)使用Params。HttpRequest 對(duì)象會(huì)在頁(yè)面創(chuàng)建前將數(shù)據(jù)封裝,因此,頁(yè)面的任何事件都可以隨意調(diào)用Page.Request.對(duì)于自提交的asp.net頁(yè)面,不需要使用Request是由于可以借助于一個(gè)強(qiáng)類(lèi)型的編程模型,但是對(duì)于以前,可靠的 HttpRequest 對(duì)象依然是需要時(shí)為您而備的。
還有一件有趣的事要注意,當(dāng)用戶(hù)點(diǎn)擊Search按鈕時(shí),search.aspx被調(diào)用,它只接受那些Html 表單上發(fā)送回來(lái)的數(shù)據(jù),不會(huì)有視圖狀態(tài)被回傳,也沒(méi)有額外的數(shù)據(jù)傳遞。如果必須提交數(shù)據(jù)到另一個(gè)頁(yè)面,使用傳統(tǒng)風(fēng)格仍然是多數(shù)高效性能的明智之選。如隨后本專(zhuān)欄所述,asp.net 2.0 跨頁(yè)提交特性傳遞了相當(dāng)大的,類(lèi)視圖狀態(tài)的數(shù)據(jù)域。
多 < form> 標(biāo)記
如果多個(gè)服務(wù)器端form出現(xiàn)在同一個(gè)web form上,將拋出異常。不易發(fā)現(xiàn)并不為人知的是,事實(shí)上web form可以包含任意數(shù)量的服務(wù)器端form,只要同一時(shí)刻僅有一個(gè)可見(jiàn)并呈現(xiàn)。例如,一個(gè)頁(yè)面包含有3個(gè)帶有runat="server"標(biāo)記的< form>是允許的,但是僅有一個(gè)form的Visible屬性可以設(shè)置為true.通過(guò)激活HtmlForm類(lèi)的Visible屬性,您可以在頁(yè)面的生命周期改變活動(dòng)的服務(wù)器端form。這個(gè)小竅門(mén)不能解決同時(shí)有多個(gè)活動(dòng)form的問(wèn)題,但是有時(shí)還是有所幫助的。
讓我們考慮一下圖4中的頁(yè)面,所有的< form>被標(biāo)記為runat="server",但是只有第一個(gè)是可見(jiàn)的,互斥的form在asp.net 1.x中很順利的實(shí)現(xiàn)了一個(gè)向?qū)АMㄟ^(guò)在按鈕事件中轉(zhuǎn)換各form的可見(jiàn)性,您可以獲得一個(gè)類(lèi)向?qū)У男袨?,參看圖5:
ASP.NET表單:類(lèi)向?qū)ы?yè)面的運(yùn)行效果
這個(gè)技巧在asp.net 2.0中基本沒(méi)用,因?yàn)槟鷷?huì)發(fā)現(xiàn)有2個(gè)新控件:MultiView 和 Wizard。MultiView控件使用邏輯等同的互斥表單,可惜它使用panel而沒(méi)用正統(tǒng)的form。MultiView允許你定義多個(gè)互斥的HTML panel,并提供了API來(lái)切換這幾個(gè)panel的可見(jiàn)性,并確保同一時(shí)刻只有一個(gè)被激活并可見(jiàn)。MultiView控件沒(méi)有提供內(nèi)建的用戶(hù)接口。Wizard控件僅是MultiView加上一個(gè)類(lèi)向?qū)У念A(yù)定義的UI塊,我在MSDN雜志2004年11期上講解過(guò)它(參閱 Cutting Edge: The asp.net 2.0 Wizard Control )。
ASP.NET表單·Cross-Page Posting(跨頁(yè)提交)
asp.net 2.0 提供了一個(gè)新的內(nèi)建進(jìn)制以覆蓋常規(guī)處理周期并允許頁(yè)面提交到另一個(gè)頁(yè)面。通常,postback發(fā)生在下面兩種方式之一:Submit按鈕激發(fā)或通過(guò)script激發(fā)。典型的按鈕提交自動(dòng)指向form指定的提交地址,而如果提交是通過(guò)script時(shí)則更加靈活機(jī)動(dòng)。在asp.net 2.0中,您可以配置某個(gè)控件(尤其那些實(shí)現(xiàn)了新的IButtonControl接口的)使其可以提交給其他目標(biāo)頁(yè)面,具體可以查閱cross-page posting。
實(shí)現(xiàn)IButtonControl的核心控件是Button, ImageButton, 和 LinkButton。通常,通過(guò)實(shí)現(xiàn)IButtonControl,所有的自定義控件都可以有表單中的按鈕同樣的效果。IButtonControl接口正是一個(gè)asp.net從1.0到2.0遷移時(shí)代碼重構(gòu)的一個(gè)典型例子。IButtonControl接口聚合了asp.net 1.x支持的多數(shù)按鈕控件(包括一些html按鈕控件)的一些屬性。另外,一些新的屬性公布了新增的功能,象PostBackUrl 和 ValidationGroup,圖6詳細(xì)描述了IButtonControl接口。接下來(lái)的代碼片斷演示了如何使用:
當(dāng)PostBackUrl屬性被設(shè)置,asp.net運(yùn)行時(shí)為按鈕控件的相應(yīng)的html元素綁定一個(gè)新的JavaScript功能。將會(huì)使用新的WebForm_DoPostBackWithOptions函數(shù)取代常規(guī)我們使用的__doPostback函數(shù),客戶(hù)端呈現(xiàn)效果如下:
結(jié)果是,當(dāng)用戶(hù)點(diǎn)擊按鈕時(shí),當(dāng)前的表單提交內(nèi)容給指定的目標(biāo)頁(yè)。那么視圖狀態(tài)的情況呢?當(dāng)含有可以cross-page posting的控件時(shí),頁(yè)面會(huì)創(chuàng)建一個(gè)name為_(kāi)_PREVIOUSPAGE的隱藏域,此域包含了提交頁(yè)的信息。目標(biāo)頁(yè)使用此信息來(lái)創(chuàng)建一個(gè)完整狀態(tài)的引用來(lái)調(diào)用頁(yè)對(duì)象。
在目標(biāo)頁(yè),您可以使用Page類(lèi)的新增的一個(gè)屬性PreviousPage來(lái)引用提交頁(yè)和頁(yè)面上所有的控件。下面是目標(biāo)頁(yè)面對(duì)form中某TextBox內(nèi)容檢索的后臺(tái)代碼:
- protected void Page_Load(object sender, EventArgs e)
- {
- // Retrieves some posted data
- TextBox txt = (TextBox) PreviousPage.FindControl("TextBox1");
- ...
- }
通過(guò)使用Page類(lèi)的PreviousPage屬性,可以訪(fǎng)問(wèn)提交頁(yè)上聲明的任意輸入控件.對(duì)輸入控件的訪(fǎng)問(wèn)是弱類(lèi)型的并間接使用FindControl方法.擺在事實(shí)面前的問(wèn)題是目標(biāo)頁(yè)面并不知道關(guān)于提交頁(yè)類(lèi)型的任何信息.同樣地,它也不能提供對(duì)源頁(yè)面類(lèi)的指定成員的訪(fǎng)問(wèn).
此外,注意FindControl僅僅查找當(dāng)前container中的控件,如果你要找的控件是在另一個(gè)控件內(nèi)部(比如模板),您必須首先取得這個(gè)container的引用然后再搜索container來(lái)查找那個(gè)控件.為了避免完全借助FindControl,還需要另一種途徑.
為了檢索提交頁(yè)面上的的值,FindControl將僅提供安全的選項(xiàng)當(dāng)您預(yù)先不知道將會(huì)調(diào)用哪個(gè)目標(biāo)頁(yè)時(shí).然而,當(dāng)在應(yīng)用程序的上下文中使用cross-page posting時(shí),將有機(jī)會(huì)確切知道的是誰(shuí)將調(diào)用和如何調(diào)用這個(gè)頁(yè)面.這種情況下,您可以利用PreviousPageType指令使目標(biāo)頁(yè)的PreviousPageType屬性強(qiáng)類(lèi)型為源頁(yè)面類(lèi).在目標(biāo)頁(yè),添加下面的指令:
指令可以為兩個(gè)互斥屬性之一:VirtualPath 或 TypeName.VirtualPath指提交頁(yè)的URL,TypeName則指明調(diào)用頁(yè)的類(lèi)型.PreviousPageType指令使目標(biāo)頁(yè)P(yáng)reviousPage屬性返回給定路徑上的頁(yè)面相同類(lèi)型(或者TypeName屬性指定的類(lèi)型)的一個(gè)對(duì)象引用,而事實(shí)本身是您不能直接訪(fǎng)問(wèn)輸入控件.在asp.net中,每個(gè)頁(yè)面類(lèi)包含了子控件對(duì)應(yīng)的protected成員.不幸的是,您不能調(diào)用外部類(lèi)的受保護(hù)成員.事實(shí)上,只有派生類(lèi)可以訪(fǎng)問(wèn)父類(lèi)的受保護(hù)成員.
為了達(dá)到這個(gè)目的,您必須在調(diào)用頁(yè)上在一個(gè)public屬性來(lái)進(jìn)行提交頁(yè)信息的訪(fǎng)問(wèn).例如,假象crosspostpage.aspx頁(yè)上包含一個(gè)名字為_(kāi)textBox1的TextBox,為了使它能夠在目標(biāo)頁(yè)訪(fǎng)問(wèn),必須在后臺(tái)類(lèi)增加如下代碼:
- public TextBox TextBox1
- {
- get { return _textBox1; }
- }
作為cross-page調(diào)用潛在可能的目標(biāo),不會(huì)自動(dòng)將目標(biāo)頁(yè)成為別的類(lèi)型.通常目標(biāo)頁(yè)總是被自身調(diào)用,例如通過(guò)一個(gè)超鏈接.這種情況發(fā)生時(shí)PreviousPage屬性返回null并且別的回傳相關(guān)的屬性(象IsPostBack)采用常規(guī)值.對(duì)于雙重功能的頁(yè)面,好的辦法是添加額外的代碼來(lái)分辨頁(yè)面的行為.下面的Page_Load事件中的代碼使頁(yè)面只工作于cross-page調(diào)用方式:
- if (PreviousPage == null)
- {
- Response.Write("Sorry, that's not the right way to invoke me.");
- Response.End();
- return;
- }
ASP.NET表單·頁(yè)面重定向
除了按鈕控件的PostBackUrl屬性,asp.net提供了另一個(gè)頁(yè)面間傳遞控件和值的機(jī)制:Server.Transfer方法.當(dāng)你調(diào)用此方法,新頁(yè)面的URL不會(huì)反映到瀏覽器的地址欄,因?yàn)檫@種頁(yè)面轉(zhuǎn)向發(fā)生服務(wù)器端--在客戶(hù)端不會(huì)有任何間接事件發(fā)生.下面的代碼演示了如何使用此方法來(lái)進(jìn)行頁(yè)面定向:
- protected void Button1_Click(object sender, EventArgs e)
- {
- Server.Transfer("targetpage.aspx");
- }
注意下面對(duì)頁(yè)面中進(jìn)行重定向的調(diào)用代碼不會(huì)被執(zhí)行.最后,Transfer只是頁(yè)轉(zhuǎn)向的方法.可是,卻對(duì)兩種情況十分有效:第一,客戶(hù)端的請(qǐng)求.例如,使用Response.Redirect.第二,同一個(gè)應(yīng)用程序中某請(qǐng)求要在新的頁(yè)面請(qǐng)求被重用.
對(duì)于asp.net 1.x,可以通過(guò)使用http上下文的Handler屬性獲取調(diào)用對(duì)象,象下面所示:
Page caller = (Page) Context.Handler;
由于Handler屬性返回了一個(gè)有效的對(duì)象引用,主體頁(yè)可以訪(fǎng)問(wèn)它的public成員,但是象我們上面討論過(guò)的不能直接訪(fǎng)問(wèn)頁(yè)面上受保護(hù)級(jí)別的控件.
本編程模型也使用于asp.net 2.0, 不過(guò),在 asp.net 2.0中,變得更簡(jiǎn)單了,不再需要使用Handler.你可以使用與cross-page postings相同的編程模型并借助一個(gè)非空的PreviousPage屬性和強(qiáng)類(lèi)型訪(fǎng)問(wèn)輸入域的@PreviousPageType指令來(lái)處理.那么頁(yè)面如何才能檢測(cè)它是被server transfer調(diào)用還是cross-page postback?兩種方式下PreviousPage都是非空的,但是PreviousPage對(duì)象的Page.IsCrossPagePostBack在cross-page posting方式是為true,而erver transfer則為false.
小結(jié)
從一個(gè)頁(yè)面?zhèn)髦档搅硪粋€(gè)頁(yè)面有很多種方法可以達(dá)成--cross-page posting,server transfer,HTML forms, cookies, session-state, query strings, 或者其他方法等等.那么最有效的是哪個(gè)呢?在 asp.net 2.0中,cross-page posting 和 server transfer提供了一個(gè)常見(jiàn)的編程模型,但卻潛在地通過(guò)View State移動(dòng)了大塊的數(shù)據(jù)。而這些信息是否真正需要依賴(lài)于目標(biāo)頁(yè)面的描述。在很多情況下,目標(biāo)頁(yè)面僅僅需要接收啟動(dòng)運(yùn)作的一些參數(shù)。if this is so,HTML客戶(hù)端表單可能用移動(dòng)數(shù)據(jù)更加有效,盡管HTML表單需要一個(gè)類(lèi)ASP的編程模型。
asp.net 2.0為HtmlForm類(lèi)增加了一些新的特性,然而核心行為并未改變,因此提交自身仍是asp.net編程的主要方法。您可以混合客戶(hù)端form和服務(wù)器form,也可以擁有多個(gè)服務(wù)器form不過(guò)同一時(shí)間內(nèi)僅有一個(gè)可見(jiàn)。
【編輯推薦】