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(默认)表示< p>,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>
<p>
<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>
</p>
</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>
<p>
<asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
用户名:<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server">
<ContentTemplate>
<p>
<asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
密码:<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</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>
<p>
<asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
用户名:<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode=" Conditional">
<ContentTemplate>
<p>
<asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
密码:<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</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>
<p>
<asp:DropDownList ID="ddlCity" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
用户名:<asp:TextBox ID="txtUserName" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</ContentTemplate>
<Triggers>
<asp:AsyncPostBackTrigger ControlID="btnPart" EventName="Click" />
</Triggers>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
<ContentTemplate>
<p>
<asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
密码:<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</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>
<p>
<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" />
</p>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Always">
<ContentTemplate>
<p>
<asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
密码:<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</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>
<p>
<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" />
</p>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
<ContentTemplate>
<p>
<asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
密码:<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</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>
<p>
<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" />
</p>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional" ChildrenAsTriggers="false">
<ContentTemplate>
<p>
<asp:DropDownList ID="ddlCounty" runat="server" AutoPostBack="True"></asp:DropDownList>
<br />
密码:<asp:TextBox ID="txtUserPwd" runat="server"></asp:TextBox><%=DateTime.Now %>
</p>
</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
相关阅读
ScriptManager和UpdatePanel控件联合使用可以实现页面异步局部更新的效果。其中的UpdatePanel就是设置页面中异步局部更新区域,
ASP.NET中使用UpdatePanel实现局部异步刷新方法和攻略
asp.net UpdatePanel实现异步局部刷新如有雷同,不胜荣欣,若转载,请注明鉴于最近项目需要,研究了一下UpdatePanel控件的使用方法,现总结