母版頁

使用 ASP.NET 母版頁可以為應用程式中的頁創建一致的布局。單個母版頁可以為應用程式中的所有頁(或一組頁)定義所需的外觀和標準行為。

基本介紹

  • 中文名:母版頁
  • 性質:應用程式中的頁創建一致的布局
  • 優點:以便可以只在一個位置上進行更新
  • 擴展名:是.master
介紹,優點,示例代碼,內容頁,編程須知,運行機制,運行過程,事件順序,

介紹

然後可以創建包含要顯示的內容的各個內容頁。當用戶請求內容頁時,這些內容頁將與母版頁合併,從而產生將母版頁的布局與內容頁中的內容組合在一起的輸出。
母版頁的使用與普通頁面類似,可以在其中放置檔案或者圖形、任何的HTML控制項和Web控制項,後置代碼等。母版頁的擴展名以.master結尾,不能被瀏覽器直接查看。母版頁必須在被其他頁面使用後才能進行顯示。
它的使用跟普通的頁面一樣,可以可視化的設計,也可以編寫後置代碼。與普通頁面不一樣的是,它可以包含ContentPlaceHolder控制項,ContentPlaceHolder控制項就是可以顯示內容頁面的區域。
母版頁僅僅是一個頁面模板,單獨的母版頁是不能被用戶所訪問的。單獨的內容頁也不能夠使用。母版頁和內容頁有著嚴格對應關係。母版頁中包含多少個ContentPlaceHolder控制項,那么內容頁中也必須設定與其相對應的Content控制項。當客戶端瀏覽器向伺服器發出請求,要求瀏覽某個內容頁面時,引擎將同時執行內容頁和母版頁的代碼,並將最終結果傳送給客戶端瀏覽器。

優點

母版頁具有下面的優點:
— 使用母版頁可以集中處理頁的通用功能,以便可以只在一個位置上進行更新。
— 使用母版頁可以方便地創建一組控制項和代碼,並將結果套用於一組頁。例如,可以在母版頁上使用控制項來創建一個套用於所有頁的選單。
— 通過允許控制占位符控制項的呈現方式,母版頁使您可以在細節上控制最終頁的布局。
— 母版頁提供一個對象模型,使用該對象模型可以從各個內容頁自定義母版頁。

示例代碼

<%@ Master Language="C#" AutoEventWireup="true" CodeFile="MasterPage.master.cs" Inherits="MasterPage" %>
......
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
......
注意:
1、這裡的聲明指示符是“<%@ Master...%>”
2、其內部包含<asp:contentplaceholder......>控制項

內容頁

擴展名是.aspx。
在建立內容頁面的時候,在“添加新項”對話框中要選中“選擇母版頁”複選框。這樣建立的頁面就是內容頁面,內容頁面在顯示的時候會把母版面的內容以水印淡化的形式一起顯示出來,而在母版頁中的ContentPlaceHolder控制項區域會被內容頁面中的Content控制項替換,程式設計師可以在這裡編寫內容頁面中的內容。
代碼如下:
<%@ Page Language="C#" MasterPageFile="~/MasterPage/MP.master" AutoEventWireup="true" CodeFile="Show1.aspx.cs" Inherits="MasterPage_Show1" Title="Untitled Page" %>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">
</asp:Content>
注意:
1、這裡的聲明指示符中多了一項MasterPageFile="~/MasterPage/MP.master",這一項是在創建內容頁面時根據“選擇母版頁”複選框的選中情況生成的。它指明了該頁是內容頁面,也指明了該內容頁面的母版頁是哪個頁面。
2、“<asp:Content ......>”就是要在其中顯示的內容。

編程須知

一、在母版頁中編寫後台代碼,訪問母版頁中的控制項:
與普通的aspx頁面一樣,雙擊按鈕即可編寫母版頁中的代碼
二、在內空頁面中編寫後台代碼,訪問內容頁面中的控制項:
與普通的aspx頁面一樣,雙擊按鈕即可編寫母版頁中的代碼
三、在內容頁面中編寫代碼訪問母版頁中的控制項:
在內容頁面中有個Master對象,它是MasterPage類型,它代表當前內容頁面的母版頁。通過這個對象的FindControl方法,我們可以找到母版面中的控制項,這樣就可以在內容頁面中操作母版頁中的控制項了。
TextBox txt = (TextBox)((MasterPage)Master).FindControl("txtMaster");
txt.Text = this.txtContent1.Text; ;
四、在內容頁面中編寫代碼訪問母版頁中的屬性和方法:
仍可能通過Master對象進行訪問,只不過在這裡要把Master對象轉換成具體的母版頁類型,然後再調用母版頁中的屬性和方不法。
這裡要說明的是:母版頁中要被內容頁面調用的屬性和方法必須是Public修改的。否則無法調到。
假設母版頁中有下面的屬性和方法:
public string TextValue
{
get
{
return this.txtMaster.Text;
}
set
{
this.txtMaster.Text = value;
}
}
public void show(string str)
{
txtMaster.Text = str;
}
在內容頁面中可以通過下代的代碼來實現對母版頁中方法的調用:
((MasterPage_MP)Master).show(this.txtContent1.Text);
((MasterPage_MP)Master).TextValue = this.txtContent1.Text;
五、在母版頁中訪問內容頁面的控制項:
在母版頁中可以通過在ContentPlaceHolder控制項中調用FindControl方法來取得控制項,然後對控制項進行操作。
((TextBox)this.ContentPlaceHolder1.FindControl("txtContent1")).Text = this.txtMaster.Text;
六、在母版頁中訪問內容頁面中的方法和屬性:
在母版頁中調用子頁面中的屬性和方法有點難度,因為我們無法像上一步中那樣通過FindControl來找到方法和屬性。
於是我們想到在母版面的聲明指示符中加入下面的代碼:
<%@ Reference Page="~/MasterPage/Show1.aspx" %>
在運行的時候回發現有錯誤,錯誤的內容是“無法實現循環引用”。這是因為默認在子頁面中引用了母版頁,你也就不能再在母版頁中引用子頁面了。
我在網上也沒找到更好的解決方法,但這使我們想起C#是的“反射”,它可以使我們動態獲取頁面對象,並且可以調用它的屬性和方法。
代碼如下:
Type t = this.ContentPlaceHolder1.Page.GetType();
PropertyInfo pi = t.GetProperty("ContentValue"); //獲取ContentValue屬性
pi.SetValue(this.ContentPlaceHolder1.Page,this.txtMaster.Text,null); //給屬性賦值
MethodInfo mi = t.GetMethod("SetValue"); //獲取SetValue()方法
object[] os = new object[1]; //建造輸入參數
os[0] = txtMaster.Text;
mi.Invoke(this.ContentPlaceHolder1.Page, os); //調用SetValue方法
七、在有多個內容頁面使用母版面的情況下,在母版頁中根據不同的內容頁面實現不同的操作
在母版頁中可以加入多個不同的內容頁面,但在設計期間,我們無法知道當前運行的是哪個內容頁面。所以只能通過分支判斷當前運行的是哪個子頁面,來執行不同的操作。這裡也用到了反射的知識。
代碼如下:
string s = this.ContentPlaceHolder1.Page.GetType().ToString(); //取出內容頁面的類型名稱
if (s == "ASP.default17_aspx") //根據不同的內容頁面類型執行不同的操作
{
((TextBox)this.ContentPlaceHolder1.FindControl("TextBox2")).Text = "MastPage";
}
else if (s == "ASP.default18_aspx")
{
((TextBox)this.ContentPlaceHolder1.FindControl("TextBox2")).Text = "Hello MastPage";
}
八、在母版面與內容頁面中JS代碼的操作
在母版頁或內容頁面中的控制項運行之後會自動生成ID,如文本框的ID是txtContent1,在運行之後ID會自動變為ctl00_ContentPlaceHolder2_txtContent1,name屬性會變為ctl00$ContentPlaceHolder2$txtContent1。
在JS代碼中,我們用document.getElementById()方法,根據id取得控制項對象的時候,應當使用ctl00_ContentPlaceHolder2_txtContent1這個ID名,否則會產生“未找到對象”的異常。

運行機制

母版頁僅僅是一個頁面模板,單獨的母版頁是不能被用戶所訪問的。單獨的內容頁也不能夠使用。母版頁和內容頁有著嚴格對應關係。母版頁中包含多少個ContentPlaceHolder控制項,那么內容頁中也必須設定與其相對應的Content控制項。當客戶端瀏覽器向伺服器發出請求,要求瀏覽某個內容頁面時,ASP.NET引擎將同時執行內容頁和母版頁的代碼,並將最終結果傳送給客戶端瀏覽器。

運行過程

母版頁和內容頁的運行過程可以概括為以下5個步驟。
(1)用戶通過鍵入內容頁的URL來請求某頁。
(2)獲取內容頁後,讀取@Page指令。如果該指令引用一個母版頁,則也讀取該母版頁。如果是第一次請求這兩個頁,則兩個頁都要進行編譯。
(3)母版頁合併到內容頁的控制項樹中。
(4)各個Content控制項的內容合併到母版頁中相應的ContentPlaceHolder控制項中。
(5)呈現得到結果頁。

事件順序

(1)母版頁中控制項Init事件;
(2)內容頁中Content控制項Init事件;
(3)母版頁Init事件;
(4)內容頁Init事件;
(5)內容頁Load事件;
(6)母版頁Load事件;
(7)內容頁中Content控制項Load事件;
(8)內容頁PreRender事件;
(9)母版頁PreRender事件;
(10)母版頁控制項PreRender事件。
(11)內容頁中Content控制項PreRender事件。

相關詞條

熱門詞條

聯絡我們