button 跨頁提交 postbackurl

http://blog.csdn.net/learnren/archive/2009/04/16/4074856.aspx

在ASP.NET 1.X 版本中，頁面都是提交到自己本身，並不能方便的指定需要提交的目的頁面。例如FirstPage.aspx中的button只能提交到FirstPage.aspx，而不能提交到SecondPage.aspx。很多時候，ASP.NET 1.X這樣工作方式使我們的開發方式受到不少限制。熟悉ASP/JSP/PHP的朋友大概很不習慣，因爲以前經常使用的提交方式突然無法使用，雖然也有解決這個問題的方法（欲詳細瞭解的讀者可去微軟網站收看webcast），可是過程太煩瑣，不甚方便。令我們高興的是，ASP.NET 2.0中有了跨頁面提交的簡單方法。

　　簡單的例子

　　首先看看下面的代碼，FirstPage.aspx中的Button通過指定PostBackUrl屬性可以提交到指定的頁面:

　　FirstPage.aspx

＜%@ 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 String UserName {
　get {
　　return this.txtName.Text;
　}
}
protected void Button1_Click(object sender, EventArgs e)
{
　Label1.Text = "Postback from self. Your Name is: " + txtName.Text;
}
＜/script＞

＜html xmlns="http://www.w3.org/1999/xhtml" ＞
＜head runat="server"＞
　＜meta content="text/JScript" http-equiv="content-script-type" /＞
　＜title＞First Page＜/title＞
＜/head＞
＜body＞
　＜form id="form1" runat="server"＞
　＜div＞
　　＜h3＞The Frist Page＜/h3＞
　　Your Name:
　　＜asp:TextBox ID="txtName" runat="server" /＞
　　＜asp:Label ID="Label1" runat="server" EnableViewState="False" /＞＜br /＞
　　＜br /＞
　　＜asp:Button ID="Button1" runat="server" Text="Postback to Same Page" OnClick="Button1_Click" /＞＜br /＞
　　＜br /＞
　　＜asp:Button ID="Button2" runat="server" Text="Postback to Second Page" PostBackUrl="~/SecondPage.aspx" /＞＜br /＞
　＜/div＞
＜/form＞
＜/body＞
＜/html＞

　　SecondPage.aspx

＜%@ Page Language="C#" %＞
＜%@ PreviousPageType VirtualPath="~/FirstPage.aspx" %＞
＜!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 Page_Load(object sender, EventArgs e)
{
　this.Label1.Text = "Your Name is : " + PreviousPage.UserName;
}
＜/script＞

＜html xmlns="http://www.w3.org/1999/xhtml" ＞
＜head runat="server"＞
＜title＞Second Page＜/title＞
＜/head＞
＜body＞
＜form id="form1" runat="server"＞
＜div＞
＜h1＞This is the Second Page＜/h1＞
＜p＞＜asp:Label ID="Label1" runat="server"＞＜/asp:Label＞ ＜/p＞
＜/div＞
＜/form＞
＜/body＞
＜/html＞

　　打開FirstPage.aspx，輸入內容並按下"Postback to Second Page"按鈕提交，頁面就會提交到SecondPage.aspx，輸入的內容也會顯示在SecondPage.aspx上。注意FirstPage.aspx中Button2新增的PostBackUrl屬性，還有SecondPage.aspx中的@PreviousPageType指令。這些新增的內容，正是ASP.NET 2.0 中的跨頁提交的方案的組成部分。

　　大家可能會發現，在使用ASP.NET 2.0 的跨頁面提交功能的時候，目標頁面都是在源頁面的窗口中打開的。但有時候我們需要在新的窗口中打開目標頁面，通過修改源頁面中＜form＞的屬性可以實現這一點。如下面的代碼所示：

＜form id="MainForm" Target="_blank" runat="server"＞

讀取源頁面的信息

　　ASP.NET 2.0中，Button控件有個新增的屬性PostBackUrl，用來設置需要提交的目標頁面。因爲只要指定Button控件的PostBackUrl屬性就可以提交到其它頁面，我們可以在頁面中使用多個控件配置其PostBackUrl的屬性，提交到不同的頁面。當然也可配置多個頁面提交到同一個頁面。

　　在跨頁面提交之後，通常我們需要從源頁面中讀取控件的信息（即由瀏覽器發送的信息），以及源頁面的公共屬性。

　　讀取控件的值

　　ASP.NET 2.0的Page類新增了一個PreviousPage屬性。顧名思義，目標頁面中的這個屬性包含對源頁面的引用。這樣就可以在目標頁面中通過PreviousPage屬性訪問源頁面的信息，我們一般使用FindControl方法來查找源頁面上的控件並讀取這些控件的值。下面的代碼說明了該方法的使用：

if (Page.PreviousPage != null)
{
　TextBox txtName = (TextBox)Page.PreviousPage.FindControl("txtName");
　if (txtName != null)
　{
　　Label1.Text = txtName.Text;
　}
}

　　當我們想查找源頁面中控件屬於另一個控件或者是模板之中，就不能直接使用FindControl方法來讀取它，而是應該先獲取對該容器的引用，然後才能在該容器中查找要獲取的控件。下面的例子中，FirstPage.aspx頁面中包含一個Panel控件，其ID爲MainPanel，它還包含ID爲UserName的TextBox控件。具體代碼如下：

Panel MainPanel = (Panel)PreviousPage.FindControl("MainPanel");
if (MainPanel != null)
{
　TextBox UserName = (TextBox)MainPanel.FindControl("UserName");
　if (UserName != null)
　{
　　Label1.Text = UserName.Text;
　}
}
else
{
　Label1.Text = "Cannot find UserName control.";
}

　　讀取源頁面的公共屬性

　　一旦在目標頁面中獲取了PreviousPage的引用，就能訪問源頁面中公共控件的屬性，同樣也可訪問源頁面中的公共屬性。當然，我們需要預先在源頁面中公開需要被訪問的屬性方可在目標頁面中訪問。

　　若要獲取源頁面的公共成員，必須先獲取對源頁面的強類型引用。就像第一個例子中，我們可以使用@PreviousPageType指令來指定源頁面，它有兩個屬性分別爲：VirtualPath和TypeName。使用VirtualPath屬性指定來源頁的虛擬路徑（包含文件名），也可以使用TypeName指定源頁面的屬性。注意只能指定其中的一個，兩者都指定就會失效。如第一個例子中所示：

＜%@ PreviousPageType VirtualPath="~/FirstPage.aspx" %＞

　　如果使用了@PreviousPageType指令，目標頁面中的PreviousPage 屬性被強類型化爲源頁面的類。因此，可以直接引用源頁面的公共成員。要獲取對源頁面的強類型引用的另一種方法是在目標頁面中包含一個@Reference 指令，就像引用要在頁面中使用的其它任何類型一樣。在這種情況下，你可以在目標頁面中獲取目標頁面的PreviousPage屬性並將其強制轉換爲源頁面的類型，如下面的代碼所示：

SourcePage_aspx sourcePage;
sourcePage = (SourcePage_aspx) PreviousPage;
Label1.Text = sourcePage.UserName;

　　讀取源頁面中的Form信息

　　如果源頁面和目標頁面屬於同一個 ASP.NET 應用程序，則目標頁中的PreviousPage屬性包含對源頁面的引用。在沒有使用@PreviousPageType指令的情況下，目標頁面中PreviousPage 屬性類型化爲Page。

　　注意，如果該頁不是跨頁發送的目標頁面或者目標頁面位於不同的應用程序中，則不會初始化PreviousPage屬性。

　　如果源頁面和目標頁面屬於不同的應用程序，甚至是不同的網站，那就無法直接獲取源頁面上控件的值，但可以從Request.Form中讀取發送的數據。還有一個需要注意的問題，因爲源頁面的視圖狀態經過Hash處理，所以不能從源頁面中讀取視圖狀態。如果要在源頁面中存儲值並讓這些值可供其他應用程序中的目標頁使用，可以將這些值作爲字符串存儲在源頁面的隱藏字段中，並在目標頁面中通過 Request.Form 來訪問它們。
判斷是否爲跨頁面提交

　　跨頁面提交的時候，源頁面控件的內容被提交到目標頁面，然後瀏覽器執行POST操作（注意，不是GET）。在ASP.NET 1.x中由於頁面都是自己提交給自己，可以通過Page的IsPostBack屬性來判斷是否爲頁面提交。但是在跨頁面提交的時候，目標頁面的IsPostBack屬性爲false。如果要判斷是否爲跨頁面提交，可以對目標頁面的PreviousPage屬性返回的引用頁面的IsCrossPagePostBack屬性進行判斷，如下面的代碼所示：

if(PreviousPage != null)
{
　if(PreviousPage.IsCrossPagePostBack == true)
　{
　　Label1.Text = "跨頁面提交";
　}
}
else
{
　Label1.Text = "非跨頁面提交";
}

　　注意，如果當前頁面不是跨頁面提交的目標頁面，則其PreviousPage屬性爲空。

　　跨頁面提交 VS Server.Transfer

　　ASP.NET 2.0中，無論是跨頁面提交還是使用Server.Transfer操作，都可以使用Previousoage屬性來獲取對源頁面的引用。如果要區分它們，可以使用上面介紹的方法。

　　下面是跨頁面提交與Server.Transfer之間的一些區別：

屬 性	跨頁面提交	Server.Transfer
IsPostBack	false	false
PreviousPage	源頁面的引用	源頁面的引用
PreviousPage.IsCrossPagePostBack	true	false
IsCrossPagePostBack	false	false
IsCallBack	false	false

　　跨頁面提交是客戶端瀏覽器的行爲，而Server.Transfer則是服務器端的行爲。在後面的小節中，我們會分析跨頁面提交時客戶端瀏覽器是如何實現提交的。

　　對跨頁面提交的簡單分析

　　在上面的例子中，我們都提到設置Button的PostBackUrl屬性來實現跨頁面提交。其實只要實現IButtonControl接口的控件均可以實現這一點。Button, ImageButton, 和 LinkButton都實現了IButtonControl接口。通過實現IButtonControl，自定義控件也可以有表單中的按鈕所具有的跨頁面提交的功能。IButtonControl接口聚合了ASP.NET 1.x支持的多數按鈕控件（包括一些html按鈕控件）的一些屬性。

　　當設置了Button控件的PostBackUrl屬性之後，ASP.NET運行時將爲按鈕控件的所對應的的html元素綁定一段新的JavaScript代碼。使用新的 WebForm_DoPostBackWithOptions函數取代常規以前所使用的__doPostback函數。具體的HTML代碼示例如下：

＜input type="submit" name="Button2" value="Postback to Second Page" οnclick="javascript:WebForm_DoPostBackWithOptions(new WebForm_PostBackOptions("Button2", "", false, "", "SecondPage.aspx", false, false))" id="Button2" /＞

　　上述代碼中的WebForm_DoPostBackWithOptions函數與WebForm_PostBackOptions函數的javascript代碼如下：

function WebForm_PostBackOptions(eventTarget, eventArgument, validation, validationGroup, actionUrl, trackFocus, clientSubmit) {
this.eventTarget = eventTarget;
this.eventArgument = eventArgument;
this.validation = validation;
this.validationGroup = validationGroup;
this.actionUrl = actionUrl;
this.trackFocus = trackFocus;
this.clientSubmit = clientSubmit;
}

function WebForm_DoPostBackWithOptions(options) {
var validationResult = true;
if (options.validation) {
if (typeof(Page_ClientValidate) == 'function') {
validationResult = Page_ClientValidate(options.validationGroup);
}
}
if (validationResult) {
if ((typeof(options.actionUrl) != "undefined") && (options.actionUrl != null) && (options.actionUrl.length ＞ 0)) {
theForm.action = options.actionUrl;
}
if (options.trackFocus) {
var lastFocus = theForm.elements["__LASTFOCUS"];
if ((typeof(lastFocus) != "undefined") && (lastFocus != null)) {
if (typeof(document.activeElement) == "undefined") {
lastFocus.value = options.eventTarget;
}
else {
var active = document.activeElement;
if ((typeof(active) != "undefined") && (active != null)) {
if ((typeof(active.id) != "undefined") && (active.id != null) && (active.id.length ＞ 0)) {
lastFocus.value = active.id;
}
else if (typeof(active.name) != "undefined") {
lastFocus.value = active.name;
}
}
}
}
}
}
if (options.clientSubmit) {
__doPostBack(options.eventTarget, options.eventArgument);
}
}

　　用戶點擊按鈕時，當前表單將內容提交給PostPageUrl屬性所指定的目標頁面。當頁面中含有可以實現跨頁面提交功能的控件時，頁面會創建一個name爲__PREVIOUSPAGE的隱藏字段，此字段包含了源頁面的信息。目標頁面則使用此信息來創建一個完整狀態的引用來調用源頁面對象。上述隱藏字段的相關HTML代碼示例如下：

＜input type="hidden" name="__PREVIOUSPAGE" id="__PREVIOUSPAGE" value="ND3_1GqjDSUeAC3yLYVz-eQrkTzZLYFHliIFf7mMQVBdmwZmFi8HG4mzX5pfZY0n0" /＞

　　總 結

　　ASP.NET 2.0 新增的跨頁面提交功能，讓我們的開發過程有了更加靈活的選擇。在使用跨頁面提交的時候，我們要根據實際的情況選擇合適的方式來讀取源頁面中的信息。如果源頁面與目標頁面處於同一個應用程序之內，我們可以選擇使用@PreviousPageType指令來指定源頁面，這樣就可以使用強類型引用的好處。

　　由於ASP.NET中的每個頁面類所包含的子控件對應的是protected成員，所以您不能直接通過PreviousPage引用來訪問源頁面中的控件，而先需要將源頁面中需要被訪問的屬性公開出來。同時，建議您只將需要的信息作爲公共屬性公開，以減少可能被潛在的惡意用戶使用的信息。