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"; }
注意:
此时ScriptManager的EnablePartialRendering属性应设为true(默认即为true);
UpdatePanel的UpdateMode属性应设为Always(默认即为Always);
UpdatePanel的ChildAsTrigger属性应设为true(默认即为true);
(特定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
来自: https://blog.csdn.net/xiaouncle/article/details/77825954
【推荐】中国电信天翼云云端翼购节,2核2G云服务器一口价38元/年
【推荐】博客园携手 AI 驱动开发工具商 Chat2DB 推出联合终身会员
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· MySQL 优化利器 SHOW PROFILE 的实现原理
· 在.NET Core中使用异步多线程高效率的处理大量数据
· 聊一聊 C#前台线程 如何阻塞程序退出
· 几种数据库优化技巧
· 聊一聊坑人的 C# MySql.Data SDK
· 为什么推荐在 .NET 中使用 YAML 配置文件
· 干掉EasyExcel!FastExcel初体验
· .NET 阻止系统睡眠/息屏
· .NET 9 中的 多级缓存 HybridCache
· 快手后端面试,被面试官秒挂了!