UpdatePanel的简单用法（非嵌套）「建议收藏」

大家好，又见面了，我是你们的朋友全栈君。

ScriptManager和UpdatePanel控件联合使用可以实现页面局部异步刷新的效果。UpdatePanel用来设置页面中局部异步刷新的区域，它必须依赖于ScriptManager，因为ScriptManager控件提供了客户端脚本生成与管理UpdatePanel的功能。

ScriptManager属性	解释
EnablePartialRendering	如果启用了部分呈现且禁止了整页更新，则为 true；否则为 false。默认值为 true。

UpdatePanel属性	解释
ChildrenAsTriggers	当UpdateMode属性为Conditional时，UpdatePanel中的子控件的异步回送是否会引发UpdatePanel的更新；当UpdateMode属性为Always时，ChildrenAsTriggers必须设置为true。
RenderMode	表示UpdatePanel最终呈现的HTML元素。Block（默认）表示< div>，Inline表示< span>。
UpdateMode	表示UpdatePanel的更新模式，有两个选项：Always和Conditional，默认值是Always。Always表示不管有没有Trigger，其他控件都将更新该UpdatePanel；Conditional表示只有当前UpdatePanel的Trigger或ChildrenAsTriggers属性为true时，当前UpdatePanel中控件引发的异步回送或整页回送，或是服务器端调用Update()方法才会引发更新该UpdatePanel。

一、实例一

UpdatePanel内部控件引起的回发，来异步更新当前UpdatePanel内部其他控件的内容。
前台代码如下：

<asp:ScriptManager ID="ScriptManager1" runat="server">
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True" OnSelectedIndexChanged="ddlCity_SelectedIndexChanged"></asp:DropDownList>
        <br />
        <asp:DropDownList ID="ddlCounty" runat="server"></asp:DropDownList>
        <br />
        用户名：<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>

后台代码如下：

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        ddlCity.Items.Add(new ListItem("annotate", "1"));
        ddlCity.Items.Add(new ListItem("diagram", "2"));
        ddlCity.Items.Add(new ListItem("cryptography", "3"));
        ddlCity.Items.Add(new ListItem("explicit", "4")); 
        ddlCity.Items.Add(new ListItem("implicit", "5"));

        ddlCounty.Items.Add(new ListItem("allot", "1"));
        ddlCounty.Items.Add(new ListItem("require", "2"));
        ddlCounty.Items.Add(new ListItem("assign", "3"));
        ddlCounty.Items.Add(new ListItem("redundant", "4"));
        ddlCounty.Items.Add(new ListItem("mandatory", "5"));

        txtUserName.Text = "guoguo";
    }
}

protected void ddlCity_SelectedIndexChanged(object sender, EventArgs e)
{
    ddlCounty.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

注意：
此时ScriptManager的EnablePartialRendering属性应设为true（默认即为true）；
UpdatePanel的UpdateMode属性应设为Always（默认即为Always）；
UpdatePanel的ChildAsTrigger属性应设为true（默认即为true）；

二、实例二

UpdatePanel外部控件引起的回发，来异步更新UpdatePanel内部控件的内容。
上面的方式能够实现简单地异步局部更新的功能，但就性能方面考虑，我们应当只将数据确实会发生变化的控件放到UpdatePanel中，这就可能出现引起回发的控件不在UpdatePanel内的情况。我们有两种方式实现这种效果：
A、在Page_Load中用ScriptManager1.RegisterAsyncPostBackControl()注册一下要实现异步回发的控件。
B、用触发器来实现更新特定UpdatePanel。

（所有UpdatePanel都刷新）方法A前台代码：

<asp:ScriptManager ID="ScriptManager1" runat="server">
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        用户名：<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        密码：<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:Button ID="btnPart" runat="server" Text="局部刷新" OnClick="btnPart_Click" />
<asp:Button ID="btnPage" runat="server" Text="整页刷新" OnClick="btnPage_Click" />

（所有UpdatePanel都刷新）方法A后台代码：

protected void Page_Load(object sender, EventArgs e)
{
    ScriptManager1.RegisterAsyncPostBackControl(this.btnPart);
    if (!IsPostBack)
    {
        ddlCity.Items.Add(new ListItem("annotate", "1"));
        ddlCity.Items.Add(new ListItem("diagram", "2"));
        ddlCity.Items.Add(new ListItem("cryptography", "3"));
        ddlCity.Items.Add(new ListItem("explicit", "4"));
        ddlCity.Items.Add(new ListItem("implicit", "5"));

        ddlCounty.Items.Add(new ListItem("allot", "1"));
        ddlCounty.Items.Add(new ListItem("require", "2"));
        ddlCounty.Items.Add(new ListItem("assign", "3"));
        ddlCounty.Items.Add(new ListItem("redundant", "4"));
        ddlCounty.Items.Add(new ListItem("mandatory", "5"));

        txtUserName.Text = "guoguo";
        txtUserPwd.Text = "bala";
    }
}

protected void btnPart_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

protected void btnPage_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

（特定UpdatePanel刷新）方法A前台代码：
需要在btnPart控件的Click事件方法体的后面加入代码：UpdatePanel1.Update();

<asp:ScriptManager ID="ScriptManager1" runat="server">
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        用户名：<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode=" Conditional">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        密码：<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:Button ID="btnPart" runat="server" Text="局部刷新" OnClick="btnPart_Click" />
<asp:Button ID="btnPage" runat="server" Text="整页刷新" OnClick="btnPage_Click" />

（特定UpdatePanel刷新）方法A后台代码：

protected void Page_Load(object sender, EventArgs e)
{
    ScriptManager1.RegisterAsyncPostBackControl(this.btnPart);
}

protected void btnPart_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
    this.UpdatePanel1.Update();
}

protected void btnPage_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

注意，特定刷新UpdatePanel1时：
UpdatePanel1、UpdatePanel2的UpdateMode设为Conditional，可实现UpdatePanel1定向刷新；
UpdatePanel1、UpdatePanel2的UpdateMode设为Always，则所有的UpdatePanel都不能刷新；
UpdatePanel1的UpdateMode设为Conditional，UpdatePanel2的UpdateMode设为Always，则所有的UpdatePanel都刷新；
UpdatePanel1的UpdateMode设为Always，UpdatePanel2的UpdateMode设为Conditional，则所有的UpdatePanel都不能刷新；

方法B前台代码：
a.选中要进行局部更新的UpdatePanel控件
b.在属性页中点击Trigger(集合)属性右边的小按钮
c.在对话框中的成员列表中添加一个AsyncPostBackTriggers成员
d.指定AsyncPostBackTriggers成员的ControlID和EventName
e.所有UpdatePanel的UpdateMode都设为Conditional，否则四种情况的效果与上一示例相同
f.一个UpdatePanel上可以有多个触发器，实现在不同的情况下对该UpdatePanel控件内容地更新

<asp:ScriptManager ID="ScriptManager1" runat="server">
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        用户名：<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
    <Triggers>
        <asp:AsyncPostBackTrigger ControlID="btnPart" EventName="Click" />
    </Triggers>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        密码：<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:Button ID="btnPart" runat="server" Text="局部刷新" OnClick="btnPart_Click" />
<asp:Button ID="btnPage" runat="server" Text="整页刷新" OnClick="btnPage_Click" />

方法B后台代码：

protected void btnPart_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
    this.UpdatePanel1.Update();
}

protected void btnPage_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

三、实例三

两个UpdatePanel控件，其中一个UpdatePanel内部控件引发两个UpdatePanel控件同时刷新。
两个UpdatePanel的UpdateM必须是Always。
前台代码：

<asp:ScriptManager ID="ScriptManager1" runat="server">
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Always">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        用户名：<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
        <br />
        <asp:Button ID="btnPart" runat="server" Text="局部刷新" OnClick="btnPart_Click" />
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Always">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        密码：<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>

后台代码：

protected void btnPart_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

四、示例四

两个UpdatePanel控件，其中一个UpdatePanel内部控件引发当前UpdatePanel内部
其他控件刷新，而另一个UpdatePanel不刷新。
两个UpdatePanel的UpdateM必须是Conditional。
前台代码：

<asp:ScriptManager ID="ScriptManager1" runat="server">
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        用户名：<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
        <br />
        <asp:Button ID="btnPart" runat="server" Text="局部刷新" OnClick="btnPart_Click" />
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        密码：<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
</asp:UpdatePanel>

后台代码：

protected void btnPart_Click(object sender, EventArgs e)
{
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

五、实例五

两个UpdatePanel控件，其中一个UpdatePanel1内部控件引发另一个UpdatePanel2控件刷新，但本身不刷新。
a.两个UpdatePanel的UpdateM必须是Conditional。
b.两个UpdatePanel的ChildrenAsTriggers必须是false
c.在UpdatePanel2中添加一个触发器，触发源为UpdatePanel1中btnPart的Click事件

前台代码：

<asp:ScriptManager ID="ScriptManager1" runat="server">
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional" ChildrenAsTriggers="false">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        用户名：<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
        <br />
        <asp:Button ID="btnPart" runat="server" Text="局部刷新" OnClick="btnPart_Click" />
    </div>
    </ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional" ChildrenAsTriggers="false">
    <ContentTemplate>
    <div>    
        <asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
        <br />
        密码：<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
    </div>
    </ContentTemplate>
    <Triggers>
        <asp:AsyncPostBackTrigger ControlID="btnPart" EventName="Click" />
    </Triggers>
</asp:UpdatePanel>

后台代码：

protected void btnPart_Click(object sender, EventArgs e)
{
    //ddlCity和txtUserName都是UpdatePanel1中的控件
    //虽然后台做了处理但是前台控件内容不会发生变化
    //因为btnPart的Click事件只能异步更新UpdatePanel2中的内容
    ddlCity.Items.Add(new ListItem("bonus", "6"));
    txtUserName.Text += "9";
}

六、UpdateProgress

属性：
DynamicLayout：隐藏时是否占位，默认值为true
DisplayAfter：延迟多少时间后显示，单位毫秒，默认值为500
AssociatedUpdatePanelID：关联的UpdatePanel的ID，默认为NULL

七、总结

UpdatePanel确实很有用，但是我们在使用过程中一定要注意它可能给我们带来的问题，例如：弹出框不显示等。使用的话确保UpdatePanel包含的内容都是自己需要更新的部分。
如果遇到了弹出框不显示的问题请参考：http://blog.csdn.net/xiaouncle/article/details/52290451

发布者：全栈程序员-用户IM，转载请注明出处：https://javaforall.cn/163530.html原文链接：https://javaforall.cn

【正版授权，激活自己账号】： Jetbrains全家桶Ide使用，1年售后保障，每天仅需1毛

【官方授权正版激活】： 官方授权正版激活支持Jetbrains家族下所有IDE 使用个人JB账号...