ASP.NET中使用UpdatePanel實現局部異步刷新方法和攻略(轉)

asp.net UpdatePanel實現異步局部刷新
 
如有雷同，不勝榮欣，若轉載，請注明
 
鑒於最近項目需要，研究了一下UpdatePanel控件的使用方法，現總結如下，可能有很多地方不足，還望大家斧正哦，此文的目的也是為了幫助UpdatePanel的初學者，也是為了給自己的學習之路留個腳印，以便自己查缺補漏，廢話到此，下面直接開始
 
UpdatePanel局部刷新的使用
 
ScriptManager和UpdatePanel控件聯合使用可以實現頁面異步局部更新的效果。其中的UpdatePanel就是設置頁面中異 步局部更新區域，它必須依賴於ScriptManager存在，因為ScriptManger控件提供了客戶端腳本生成與管理UpdatePanel的功能。
 
ScriptManager控件重要的屬性：
     ScriptManager控件的EnablePartialRendering屬性：true-表示實現頁面的異步局部更新;false-表示實現全頁面的刷新。此屬性默認值為true
 UpdatePanel控件重要的屬性：
     UpdatePanel控件的RenderMode屬性：InLine，UpdatePanel控件被解析成HTML的<span>標記;Block，UpdatePanel控件被解析成HTML控件的<div>。
     UpdatePanel控件的UpdateMode屬性：Always，UpdatePanel頁面上任何一處發生的回發操作都會產生頁局部更新;Conditional，只在特定的情況下才產生頁面的回發，如執行UpdatePanel控件的update()方法或在指定的觸發器的操作下，UpdatePanel控件的UpdateMode默認為"Always"。
     UpdatePanel控件的ChildAsTrigger屬性：指示UpdatePanel內部控件引起的回發是否產生當前UpdatePanel控件的局部更新。如果UpdateMode設為Always的話，那ChildAsTrigger屬性必須設為True，否則運行出錯。
 
一、UpdatePanel內部的控件引起的回發，來更新當前UpdatePanel內部的控件內容：
     1.向頁面中加入ScriptManager、UpdatePanel控件和一個Label控件，ID="Label1"。
     2.在UpdatePanel中加入一個Button、一個Label,ID="Label2"。
     3.雙擊Button在事件處理程序中寫入下列代碼：Label2.Text = DateTime.Now.ToString();
     4.在Page_Load事件中寫入下列代碼：Label1.Text = DateTime.Now.ToString();
     5.運行頁面，發現每次點擊按鈕都會產生異步局步刷新，只有Label2的內容發生更改，頁面上的Label1時間沒有發生更改。
     
    代碼如下：
         <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>
         <asp:ScriptManager ID="ScriptManager1" runat="server">
         </asp:ScriptManager>
         <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="True">
             <ContentTemplate>
                 <asp:Label ID="Label2" runat="server"></asp:Label>
                 <br />
                 <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Button" />
             </ContentTemplate>
         </asp:UpdatePanel>
     后台代碼：
         protected void Button1_Click(object sender, EventArgs e)
         {
             Label2.Text = DateTime.Now.ToString(); ;
         }
         protected void Page_Load(object sender, EventArgs e)
         {
             Label1.Text = DateTime.Now.ToString();
         } 
       注意：此時的ScriptManager的EnablePartialRendering屬性應設為true(默認即為true)。UpdatePanel的UpdateMode屬性應設為Always(默認即為Always)。ChildAsTrigger屬性應設為true(默認即為true)。
 
二、UpdatePanel控件外部的控件引起的回發，來異步更新UpdatePanel內部的內容
     雖然上面的方式能夠實現很簡單地異步局部更新的功能，但就性能方面考慮，我們應當只將數據確實會發生變化的控件擺放在UpdatePanel中，這就可能會出現引起回發的控件不在UpdatePanel內的情況。這個時候我們有兩種方式實現這種效果。
 
    A.在Page_Load方法中用ScriptManager1.RegisterAsyncPostBackControl()來注冊一下要實現異步更新的控件。
     B.用觸發器來實現。
     
    1、ScriptManager1.RegisterAsyncPostBackControl()注冊的控件可以實現對所有的UpdatePanel控件的異步更新。
         如：ScriptManager1.RegisterAsyncPostBackControl(this.Button2);實現對Button2的注冊，那此時Button2的回發就變成一個異步回發（頁面不會刷新），它會導致頁面上所有的UpdatePanel的內容的更新。
         注意：此時的ScriptManager的EnablePartialRendering屬性應設為true。UpdatePanel的UpdateMode屬性應設為Always。
 
    2、ScriptManager1.RegisterAsyncPostBackControl()注冊的控件可以實現針對特定UpdatePanel控件的異步更新。
         a.把頁面上所有的UpdatePanel控件的UpdateMode設為Conditional。
         b.ScriptManager1.RegisterAsyncPostBackControl(this.Button2);實現對Button2的注冊。
         c.在Button2控件的Click事件中后面加入后面的代碼：UpdatePanel1.Update(); 
        這樣Button2按鈕只對UpdatePanel1控件實現的異步的局部刷新。
         注意：這里的UpdatePanel的屬性要設為Conditional，如果這里多個UpdatePanel控件都設置為Always的話，所有的UpdatePanel都不會出現刷新的效果。
         如果將其中Button2事件代碼UpdatePanel1.Update()對應的UpdatePanel設置為Conditional時，則多個UpdatePanel都會出現刷新的效果，要實現多個UpdatePanel中
         其中一個實現更新效果的話，需要將UpdatePanel的UpdateMode都設置為Conditional才可以
     3、觸發器
         如果頁面上有多個UpdatePanel控件，如果要實現外部的控件的回發引發指定的UpdatePanel更新的話，那應當要為實現刷新的UpdatePanel控件建立一個觸發器。
         a.選中要進行局部更新的UpdatePanel控件。 
        b.在其屬性頁中點擊Triggers集合屬性右邊的小按鈕。
         c.在彈出的對話框中的成員列表中添加一個AsyncPostBackTriggers成員。
         d.指定AsyncPostBackTriggers成員的ControlID和EventName，即引發異步回送的控件的ID和該控件的事件。
         完成以上步驟后，切換到HTML頁面就會出現下列代碼:
         <asp:UpdatePanel ID="UpdatePanel2" runat="server" RenderMode="Inline" UpdateMode="Conditional">
             <ContentTemplate>
                 <asp:Label ID="Label3" runat="server" Text="Label"></asp:Label>
             </ContentTemplate>
             <Triggers>
                 <asp:AsyncPostBackTrigger ControlID="Button2" EventName="Click" />
             </Triggers>
         </asp:UpdatePanel>
         <asp:Button ID="Button2" runat="server" OnClick="Button2_Click" Text="ButtonOut" />
         e.b到d的步驟可以直接在html頁面中UpdatePanel控件內<ContentTemplate></ContentTemplate>之后添加
         <Triggers><asp:AsyncPostBackTrigger ControlID="Button2" EventName="Click" /></Triggers>,和上面步驟產生的代碼是一樣的
         
        這里需要大家注意的是：
            把所有的UpdatePanel控件的UpdateMode設為"Conditional"，這樣才能夠針對建有相關觸發器的UpdatePanel更新。
            一個UpdatePanel上可以建有多個觸發器，實現在不同的情況下對該UpdatePanel控件內容的更新。示例如下：
            <Triggers>
                 <asp:AsyncPostBackTrigger ControlID="Button1" EventName="Click"/>
                 <asp:AsyncPostBackTrigger ControlID="Button2" EventName="Click"/>
                 <asp:PostBackTrigger ControlID="Button3" EventName="Click"/>
             </Triggers>
            
三、兩個UpdatePanel控件，其中一個UpdatePanel內的控件引發兩個UpdatePanel控件的同時刷新。
     a.在頁面上放入兩個UpdatePanel和一個ScriptManager控件。
     b.在UpdatePanel1中加入一個標簽Label1、一個按鈕Button1 ，在UpdatePanel2中加入一個標簽Label2。
     c.將UpdatePanel1和UpdatePanel2兩個控件的的UpdateMode屬性設為"Always"
     c.在Button1的Click事件中加入下面的代碼：
         protected void Button1_Click(object sender, EventArgs e)
         {
             Label1.Text = DateTime.Now.ToString();
             Label2.Text = DateTime.Now.ToString();
         }
     d.或者只在Page_Load事件中填寫如下代碼即可
         protected void Page_Load(object sender, EventArgs e)
         {
             Label1.Text = DateTime.Now.ToString();
             Label2.Text = DateTime.Now.ToString();
         }
         
    
四、兩個UpdatePanel控件，其中一個UpdatePanel內的控件引發當前的UpdatePanel控件的刷新，而另一個不刷新。
     a.步驟和上面的（三）一樣
     b.要把UpdatePanel1和UpdatePanel2兩個控件的UpdateMode屬性設為Conditional，這里需要注意，如果將一個設置為Conditional，一個設置為Always則兩個都會刷新的
     <asp:ScriptManager ID="ScriptManager1" runat="server">
     </asp:ScriptManager>
     <asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional">
         <ContentTemplate>
             <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>
             <br />
             <asp:Button ID="Button1" runat="server" OnClick="Button1_Click1" Text="更新兩個UpdatePanel" />
         </ContentTemplate>
     </asp:UpdatePanel>
     <asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
         <ContentTemplate>
             <asp:Label ID="Label2" runat="server" Text="Label"></asp:Label>
         </ContentTemplate>
     </asp:UpdatePanel>
 五、兩個UpdatePanel控件，其中一個UpdatePanel內的控件引發另一個UpdatePanel控件的刷新，而本身不刷新。
     a.步驟和上面的（四）一樣（兩個都設置為Conditional）之后，還需要
     b.把UpdatePanel1和UpdatePanel2的ChildrenAsTriggers屬性設為false
     c.在UpdatePanel2控件中加入一個觸發器，觸發源設到UpdatePanel1控件內的Button1的Click事件上。
     <asp:ScriptManager ID="ScriptManager1" runat="server">
     </asp:ScriptManager>
     <asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional" ChildrenAsTriggers="False">
         <ContentTemplate>
             <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>
             <br />
             <asp:Button ID="Button1" runat="server" OnClick="Button1_Click1" Text="只更新UpdatePane2" />
         </ContentTemplate>
     </asp:UpdatePanel>
     <asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
         <ContentTemplate>
             <asp:Label ID="Label2" runat="server" Text="Label"></asp:Label>
         </ContentTemplate>
         <Triggers>
             <asp:AsyncPostBackTrigger ControlID="Button1" EventName="Click" />
         </Triggers>
     </asp:UpdatePanel>
 
在開發過程中難免會用到UpdatePanel控件的一些復雜的使用。
 如：UpdatePanel控件的嵌套、在母版頁中使用UpdatePanel、在用戶控件中使用UpdatePanel以及在GridView中使用UpdatePanel等。
 其實這些操作也免不了對UpdatePanel控件的UpdateMode屬性、ChildrenAsTrigger屬性以及觸發器的使用，下面是系統地說明。
 
一、兩個嵌套的UpdatePanel控件，外部的UpdatePanel內的控件回發引發二者同時更新
     在頁面上放一個ScriptManager和UpdatePanel控件（UpdatePanel1），在UpdatePanel1中放入一個標簽控件 （lb1）、一個按鈕（Button1）和另一個UpdatePanel控件（UpdatePanel2），在UpdatePanel2控件中放一 個標簽控件lb2。
     <asp:ScriptManager ID="ScriptManager1" runat="server">
     </asp:ScriptManager>
     <asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional">
         <ContentTemplate>
             <asp:Label ID="lb1" runat="server"></asp:Label>
             <asp:Button ID="Button1" runat="server" OnClick="Button1_Click2" Text="Button" />
             <asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
                 <ContentTemplate>
                     <asp:Label ID="lb2" runat="server"></asp:Label>
                 </ContentTemplate>
             </asp:UpdatePanel>
         </ContentTemplate>
     </asp:UpdatePanel>
     在Button1控件中的Click事件中加入下面的代碼：
     protected void Button1_Click2(object sender, EventArgs e)
     {
         lblIn.Text = DateTime.Now.ToString();
         lblOut.Text = DateTime.Now.ToString();
     }
     要實現外部UpdatePanel內控件的回發引起內部和外部兩個UpdatePanel控件的同時刷新的話，需要把兩個UpdatePanel控件的 UpdateMode都設為Conditional，這樣外部UpdatePanel內的控件回發會自動引起內部UpdatePanel控件的刷新。
     注意：外部UpdatePanel控件的ChildrenAsTrigger屬性要設為True，兩個UpdatePanel控件的UpdateMode要都設為 Conditional，如果UpdateMode設為Always的話也會出現兩個UpdatePanel同時刷新的效果，這樣會導致頁面上其它的 UpdatePanel控件也發生刷新。
                
二、兩個嵌套的UpdatePanel控件，內部的UpdatePanel內的控件回發引發二者同時更新
     在頁面上放一個ScriptManager和UpdatePanel控件（UpdatePanel1），在UpdatePanel1中放入一個標簽控件 （lb1）和另一個UpdatePanel控件（UpdatePanel2），在UpdatePanel2控件中放一個標簽控件lb2和一個按 鈕（Button1）。
     <asp:ScriptManager ID="ScriptManager1" runat="server">
     </asp:ScriptManager>
     <asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional">
         <ContentTemplate>
             <asp:Label ID="lb1" runat="server" ></asp:Label>
             <br />
             <asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
                 <ContentTemplate>
                     <asp:Label ID="lb2" runat="server" ></asp:Label>
                     <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Button" />
                 </ContentTemplate>
             </asp:UpdatePanel>
         </ContentTemplate>
         <Triggers>
             <asp:AsyncPostBackTrigger ControlID="Button1" EventName="Click" />
         </Triggers>
     </asp:UpdatePanel>
     在按鈕的Click事件中和（一）中的一樣。
     注意：
        把兩個UpdatePanel控件的UpdateMode屬性設為Conditional，要把內部控件ChildrenAsTrigger設為 True。但這樣內部UpdatePanel內的控件只引發自身的刷新，不會引發外部的UpdatePanel控件的刷新，不會刷新外部的 UpdatePanel控件，因此我們還需要為外部UpdatePanel控件加入一個觸發器，觸發源指定為Button1控件的Click事件上。
 
三、兩個嵌套的UpdatePanel控件，外部的UpdatePanel內的控件回發只引發內部控件的更新
     在頁面上放一個ScriptManager和UpdatePanel控件（UpdatePanel1），在UpdatePanel1中放入一個標簽控件 （lb1）、一個按鈕（Button1）和另一個UpdatePanel控件（UpdatePanel2），在UpdatePanel2控件中放一個標簽控件lb2。
     <asp:ScriptManager ID="ScriptManager1" runat="server">
     </asp:ScriptManager>
     <asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional" ChildrenAsTriggers="False">
         <ContentTemplate>
             <asp:Label ID="lb1" runat="server" ></asp:Label>
             <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Button" /><br />
             <asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
                 <ContentTemplate>
                     <asp:Label ID="lb2" runat="server" ></asp:Label>&nbsp;
                 </ContentTemplate>
                 <Triggers>
                     <asp:AsyncPostBackTrigger ControlID="Button1" EventName="Click" />
                 </Triggers>
             </asp:UpdatePanel>
         </ContentTemplate>
     </asp:UpdatePanel>
            在按鈕的Click事件中和（一）中的一樣。
     注意：
         要把兩個UpdatePanel控件的UpdateMode設為Conditional，把外部UpdatePanel控件的 ChildrenAsTrigger設為false。這樣兩個UpdatePanel控件都不會刷新，所以還要為內部的UpdatePanel控件建立觸 發器，觸發源指向外部UpdatePanel中的的Button1的Click事件上。
         
四、母版頁中使用UpdatePanel控件
     如果將ScriptManager控件添加在母版頁上的話，那么各內容頁面就沒必要再添加ScriptManager控件了，只需添加UpdatePanel控件就可以了，因為母版頁和內容頁面將來生成的是一個頁面的實例，而在一個頁面上是不允許同時存在兩個ScriptManager控件的。
     如果ScriptManager控件沒有添加在母版頁上的話，那只能把ScriptManager控件添加在其中一個內容頁面里。不要向每一個內容頁面中添加ScriptManager控件。
     1、內容頁面中的UpdatePanel內的控件引起回發，只更新當前內容頁面的內容。
         此時按鈕分別在各自的UpdatePanel控件內。
         將兩個內容頁面內的兩個UpdatePanel控件的UpdateMode設為Conditional，ChildrenAsTrigger設為True。
         在按鈕的Click事件中和（一）中的一樣。
         這樣就出現各內容頁的UpdatePanel內的按鈕只對當前內容頁起作用。
     2、在母版頁中的按鈕引起回發，更新指定內容頁的信息。       
       此時有兩個按鈕：ButtonOut在母版頁中，ButtonIn在內容頁面1中。
        當點擊ButtonOut時，異步更新兩個內容頁面的信息。當點擊ButtonIn時，異步更新母版面中的UpdatePanel1中的信息。
        母版頁HTML代碼如下：
        <div>
      母版頁
     3、<asp:ScriptManager ID="ScriptManager1" runat="server">
        </asp:ScriptManager>
         <asp:UpdatePanel ID="UpdatePanel1" runat="server" RenderMode="Inline" UpdateMode="Conditional">
             <ContentTemplate>
                 <asp:Label ID="lbl" runat="server" Text="Label"></asp:Label>
             </ContentTemplate>
         </asp:UpdatePanel>
         <br />
         <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="ButtonOut" /><br />
 
        <table width=80%>
             <tr>
                 <td>
                     <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
                     </asp:contentplaceholder>
                 </td>
                 <td bgcolor=maroon>
                     <asp:ContentPlaceHolder ID="ContentPlaceHolder2" runat="server">
                     </asp:ContentPlaceHolder>
                 </td>
             </tr>
         </table>
         <br />
        內容頁面的HTML代碼如下：
         <%@ Page Language="C#" MasterPageFile="~/MasterPage.master" AutoEventWireup="true" CodeFile="Child.aspx.cs" Inherits="Child" Title="UpdatePanel Test Page" %>
         <%@ MasterType VirtualPath="~/MasterPage.master" %>
         <asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
             <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                 <ContentTemplate>
                     <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>
             <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="ButtonInner" />
                 </ContentTemplate>
             </asp:UpdatePanel>
         </asp:Content>
 
        <asp:Content ID="Content2" runat="server" ContentPlaceHolderID="ContentPlaceHolder2">
             <asp:UpdatePanel ID="UpdatePanel2" runat="server">
                 <ContentTemplate>
                     <asp:Label ID="Label2" runat="server" Text="Label"></asp:Label>
                 </ContentTemplate>
             </asp:UpdatePanel>
         </asp:Content> 

        母版頁的CS代碼如下：
         protected void Page_Load(object sender, EventArgs e)
         {
             ScriptManager1.RegisterAsyncPostBackControl(this.Button1);
         }
         protected void Button1_Click(object sender, EventArgs e)
         {
             Label lbl1 = (Label)this.ContentPlaceHolder1.FindControl("Label1");
             lbl1.Text = DateTime.Now.ToString();
             Label lbl2 = (Label)this.ContentPlaceHolder2.FindControl("Label2");
             lbl2.Text = DateTime.Now.ToString();
         }
 
        public string BindTitle
         {
             get
             {
                 return lbl.Text;
             }
             set
             {
                 lbl.Text = value;
             }
         } 
       Child孩子頁面的CS代碼如下：
         protected void Button1_Click(object sender, EventArgs e)
         {
             Label1.Text = Master.BindTitle;
             Master.BindTitle = "ContentPage1's Action";
             ((UpdatePanel)Master.FindControl("UpdatePanel1")).Update(); ;
         } 

五、用戶控件中使用UpdatePanel控件
     如果父頁面中存在ScriptManager控件，那用戶控件的頁面中不應再放入ScriptManager控件了，只在用戶控件中加入UpdatePanel。   
     其控件的回發與更新規律與使用方式與母版頁一樣。
 
自己查看資料然后總結，若發現不足之處，還請斧正，本人將非常感謝，希望共同學習，共同進步，謝謝。。。