ASP | UpdatePanel

一、UpdatePanel控件属性

1. ScriptManager控件重要的属性：

2. UpdatePanel控件重要的属性：

3. UpdatePanel控件的UpdateMode属性：

• Always，UpdatePanel页面上任何一处发生的回发操作都会产生页局部更新;
• Conditional，只在特定的情况下才产生页面的回发，如执行UpdatePanel控件的update()方法或在指定的触发器的操作下，UpdatePanel控件的UpdateMode默认为”Always”。

4.UpdatePanel控件的ChildAsTrigger属性：

二、UpdatePanel局部刷新的使用

1. 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)。

2. 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>

3. 两个UpdatePanel控件，其中一个UpdatePanel内的控件引发两个UpdatePanel控件的同时刷新。

protected void Button1_Click(object sender, EventArgs e)
{
    Label1.Text = DateTime.Now.ToString();
    Label2.Text = DateTime.Now.ToString();
}

e. 或者只在Page_Load事件中填写如下代码即可

protected void Page_Load(object sender, EventArgs e)
{
    Label1.Text = DateTime.Now.ToString();
    Label2.Text = DateTime.Now.ToString();
}

4. 两个UpdatePanel控件，其中一个UpdatePanel内的控件引发当前的UpdatePanel控件的刷新，而另一个不刷新。

<asp:ScriptManager ID=“ScriptManager1” runat=“server”>
</asp:ScriptManager>
<asp:UpdatePanel ID=“UpdatePanel1” runat=“server” UpdateMode=“Conditional”>
    <asp:Label ID=“Label1” runat=“server” Text=“Label”></asp:Label>
    <asp:Button ID=“Button1” runat=“server” OnClick=“Button1_Click1” Text=“更新两个UpdatePanel” />
</asp:UpdatePanel>
<asp:UpdatePanel ID=“UpdatePanel2” runat=“server” UpdateMode=“Conditional”>
    <asp:Label ID=“Label2” runat=“server” Text=“Label”></asp:Label>
</asp:UpdatePanel>

5. 两个UpdatePanel控件，其中一个UpdatePanel内的控件引发另一个UpdatePanel控件的刷新，而本身不刷新。

<asp:ScriptManager ID=“ScriptManager1” runat=“server”>
</asp:ScriptManager>
<asp:UpdatePanel ID=“UpdatePanel1” runat=“server” UpdateMode=“Conditional” ChildrenAsTriggers=“False”>
    <asp:Label ID=“Label1” runat=“server” Text=“Label”></asp:Label>
    <asp:Button ID=“Button1” runat=“server” OnClick=“Button1_Click1” Text=“只更新UpdatePane2” />
</asp:UpdatePanel>
<asp:UpdatePanel ID=“UpdatePanel2” runat=“server” UpdateMode=“Conditional”>
    <asp:Label ID=“Label2” runat=“server” Text=“Label”></asp:Label>
    <asp:AsyncPostBackTrigger ControlID=“Button1” EventName=“Click” />
</asp:UpdatePanel>

三、UpdatePanel控件复杂应用

1. 两个嵌套的UpdatePanel控件，外部的UpdatePanel内的控件回发引发二者同时更新

<asp:ScriptManager ID=“ScriptManager1” runat=“server”>
</asp:ScriptManager>
<asp:UpdatePanel ID=“UpdatePanel1” runat=“server” UpdateMode=“Conditional”>
    <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”>
        <asp:Label ID=“lb2” runat=“server”></asp:Label>
    </asp:UpdatePanel>
</asp:UpdatePanel>

protected void Button1_Click2(object sender, EventArgs e)
{
    lblIn.Text = DateTime.Now.ToString();
    lblOut.Text = DateTime.Now.ToString();
}

2. 两个嵌套的UpdatePanel控件，内部的UpdatePanel内的控件回发引发二者同时更新

<asp:ScriptManager ID=“ScriptManager1” runat=“server”>
</asp:ScriptManager>
<asp:UpdatePanel ID=“UpdatePanel1” runat=“server” UpdateMode=“Conditional”>
    <asp:Label ID=“lb1” runat=“server” ></asp:Label>
    <asp:UpdatePanel ID=“UpdatePanel2” runat=“server” UpdateMode=“Conditional”>
        <asp:Label ID=“lb2” runat=“server” ></asp:Label>
        <asp:Button ID=“Button1” runat=“server” OnClick=“Button1_Click” Text=“Button” />
    </asp:UpdatePanel>
    <asp:AsyncPostBackTrigger ControlID=“Button1” EventName=“Click” />
</asp:UpdatePanel>

3. 两个嵌套的UpdatePanel控件，外部的UpdatePanel内的控件回发只引发内部控件的更新

<asp:ScriptManager ID=“ScriptManager1” runat=“server”>
</asp:ScriptManager>
<asp:UpdatePanel ID=“UpdatePanel1” runat=“server” UpdateMode=“Conditional” ChildrenAsTriggers=“False”>
    <asp:Label ID=“lb1” runat=“server” ></asp:Label>
    <asp:Button ID=“Button1” runat=“server” OnClick=“Button1_Click” Text=“Button” />
    <asp:UpdatePanel ID=“UpdatePanel2” runat=“server” UpdateMode=“Conditional”>
        <asp:Label ID=“lb2” runat=“server” ></asp:Label> 
        <asp:AsyncPostBackTrigger ControlID=“Button1” EventName=“Click” />
    </asp:UpdatePanel>
</asp:UpdatePanel>

4. 母版页中使用UpdatePanel控件

<asp:ScriptManager ID=“ScriptManager1” runat=“server”>
</asp:ScriptManager>
<asp:UpdatePanel ID=“UpdatePanel1” runat=“server” RenderMode=“Inline” UpdateMode=“Conditional”>
    <asp:Label ID=“lbl” runat=“server” Text=“Label”></asp:Label>
</asp:UpdatePanel>
<asp:Button ID=“Button1” runat=“server” OnClick=“Button1_Click” Text=“ButtonOut” />

<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(); ;
}

5. 用户控件中使用UpdatePanel控件

protected void FinishButton_Click(object sender, EventArgs e)
{
    ScriptManager.RegisterStartupScript(this.UpdatePanel1,
    this.GetType(), "FinishButton", "<script>alert    ('OK');</script>", false);
}