源自:孟子E章
--------------------
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="XsList.aspx.cs" enableEventValidation="false" Inherits="XsList" %>
--------------------
本文是《ASP.NET 2.0應用開發技術》一書內容的延伸,講述ASP.NET 2.0伺服器控制項與標記之間的關係。
《ASP.NET 2.0應用程式開發》一書中,第19頁、第1.5.6小節的內容是關於ASP.NET 2.0伺服器控制項文法的描述,由於書中只是簡單地進行了介紹,現將更多的內容補充說明如下:
1,ASP.NET 2.0伺服器控制項與<form runat=server></form>的關係
ASP.NET 2.0伺服器控制項(HTML伺服器控制項和Web伺服器控制項)是否必須需要放在<form runat=server></form>的標記之中,可以根據需要進行設定,大多數情況下,對於只用來進行介面顯示的控制項、並且不需要處理事件的控制項,可以不放在<form runat=server></form>之間,對於大多數控制項來說,是要在伺服器端進行事件處理和獲得某些傳回值的,因此需要放在<form runat=server></form>之間。
2,如何進行控制
伺服器控制項在進行Render、AddAttributesToRender等的時候,會執行下面這句:
Page page1 = this.Page;
if (page1 != null)
{
page1.VerifyRenderingInServerForm(this);
}
Page.VerifyRenderingInServerForm 方法 就是驗證伺服器控制項是否需要在<form runat=server></form>的標記之中,如果不在這個標記之中,將會引發下面的異常。例如下面的代碼:
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>VerifyRenderingInServerForm</title>
</head>
<body>
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<form id="form1" runat="server">
</form>
</body>
</html>
在瀏覽這樣的頁面時,將會引發異常:
類型“TextBox”的控制項“TextBox1”必須放在具有 runat=server 的表單標記內。
說明: 執行當前 Web 請求期間,出現未處理的異常。請檢查堆疊追蹤資訊,以瞭解有關該錯誤以及代碼中導致錯誤的出處的詳細資料。
異常詳細資料: System.Web.HttpException: 類型“TextBox”的控制項“TextBox1”必須放在具有 runat=server 的表單標記內。
這是因為,TextBox控制項在進行Render的時候調用了page1.VerifyRenderingInServerForm(this);,因此,如果不放在<form runat=server></form>的標記之間,這個驗證過程是通不過的。
但是,我們可以在代碼中重載這個方法,以便是TextBox控制項可以放在<form runat=server></form>的標記之外,例如下面的代碼:
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
public override void VerifyRenderingInServerForm(Control control)
{
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>VerifyRenderingInServerForm</title>
</head>
<body>
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<form id="form1" runat="server">
</form>
</body>
</html>
瀏覽這樣的頁面就不會產生異常。
3,調整展現方式後,頁面能否正常工作
MSDN上解釋Page.VerifyRenderingInServerForm 方法時說:
如果回傳或使用用戶端指令碼的伺服器控制項沒有包含在 HtmlForm 伺服器控制項 (<form runat="server">) 標記中,它們將無法正常工作。這些控制項可以在呈現時調用該方法,以在它們沒有包含在 HtmlForm 控制項中時提供明確的錯誤資訊。
是的,雖然下面的代碼可以正常顯示,但一旦單擊“提交”按鈕,伺服器端將得不到輸入的值,頁不能儲存狀態了。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
public override void VerifyRenderingInServerForm(Control control)
{
}
protected void Button1_Click(object sender, EventArgs e)
{
Response.Write("<li>TextBox1.Text = " + TextBox1.Text);
Response.Write("<li>Request.Params = " + Request.Params[TextBox1.UniqueID]);
}
protected void Page_Load(object sender, EventArgs e)
{
Response.Write("<li>TextBox1.Text = " + TextBox1.Text);
Response.Write("<li>Request.Params = " + Request.Params[TextBox1.UniqueID]);
if (!IsPostBack)
{
TextBox1.Text = "《ASP.NET2.0應用開發技術》";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>VerifyRenderingInServerForm</title>
</head>
<body>
<asp:TextBox ID="TextBox1" runat="server" Width="600px"></asp:TextBox>
<form id="form1" runat="server">
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click"
Text="提交" />
</form>
</body>
</html>
因此,在一般情況下,不要將伺服器控制項移到<form runat=server></form>的標記之外
4,如何強制將伺服器控制項放入<form runat=server></form>的標記之間
有些伺服器控制項可以不放在<form runat=server></form>的標記之間,如Label控制項,但如果需要強制將它放<form runat=server></form>的標記之間,可以使用下面的方法:
protected void Label1_PreRender(object sender, EventArgs e)
{
this.VerifyRenderingInServerForm(Label1);
}
5,百害而無一益?
有時候,頁面上需要放置多個form表單(雖然只放置一個<form runat=server></form>的表單也能實現),將表單控制項放在<form runat=server></form>標記之外,將非常方便使用,這在以前的asp頁面中很常見,現在在aspx中也可義實現。下面的頁面,既利用了伺服器控制項的方便性,也逃脫出了類型“TextBox”的控制項“TextBox1”必須放在具有 runat=server 的表單標記內的限制。例如:
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Button1_Click(object sender, EventArgs e)
{
Response.Write("<li>TextBox1.Text = " + TextBox1.Text);
Response.Write("<li>Request.Params = " + Request.Params[TextBox1.UniqueID]);
}
protected void Page_Load(object sender, EventArgs e)
{
KeyWords.Text = "《ASP.NET2.0應用開發技術》";
Response.Write("<li>TextBox1.Text = " + TextBox1.Text);
Response.Write("<li>Request.Params = " + Request.Params[TextBox1.UniqueID]);
if (!IsPostBack)
{
TextBox1.Text = "《ASP.NET2.0應用開發技術》";
}
}
public override void VerifyRenderingInServerForm(Control control)
{
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>VerifyRenderingInServerForm</title>
</head>
<body>
<form method="post" action="SearchDoc.aspx">
關鍵字:<asp:TextBox ID="KeyWords" runat="server"></asp:TextBox>
<asp:Button ID="Button2" runat="server" Text="搜尋" />
</form>
<form id="form1" runat="server">
<asp:TextBox ID="TextBox1" runat="server" Width="600px"></asp:TextBox>
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click"
Text="提交" />
</form>
</body>
</html>
在SearchDoc.aspx頁面,使用Request.Form即可獲得輸入的關鍵字。