asp.net ajax功能强大的updatePanel控件

作者:网络 来源:佚名 更新时间:2008-09-19 01:57:20 点击:

  先给一个简单的例子,后面给一个比较复杂的例子。

  改进后的updatepanel使页面部分更新(partial-page updates)实现起来非常容易。
 
  要想在已有web页面或新建页面中加入部分更新内容,都十分容易,下面几个步骤:

  <1>在页面中加入scriptmanager控件。并保证scriptmanager控件的enablepartialrendering属性值为 true。若enablepartialrendering=false,那么下面所做的对页面部分更新的任何设置都不能实现。enablepartialrendering的默认值是true,不作修改就行。

code highlighting produced by actipro codehighlighter (freeware)

--><asp:scriptmanager id="scriptmanager1" runat="server">
</asp:scriptmanager>

  <2>把updatepanel控件加到页面中。在 <contenttemplate></contenttemplate>中加入想部分更新的内容就行了。

<asp:updatepanel id="updatepanel1" runat="server">
            <contenttemplate>
              <fieldset>
                <legend>in updatepanel</legend>
                  updatepanel content refreshed at <%=datetime.now.tostring() %>
                 <asp:button id="button1"  text="refreshupdatepanel" runat="server" />
               </fieldset>
            </contenttemplate>
</asp:updatepanel> 

  为了对比,在updatepanel外面加一行代码

<div>out of updatepanel,refreshed at <%=datetime.now.tostring() %></div>

  这样部分更新功能就实现了,或许都不敢相信。

  看看效果吧。 

 

  两部分更新时间不一样!

  updatepanel控件的功能是很强大的。这是最简单的应用。

  部分更新时,提交给服务器的数据跟一般的postback没有什么区别,所有数据包括viewstate中的数据被传回服务器。不同的地方在于从服务器只返回部分更新部分的数据。由于updatepanel控件的引入,postback被分为两种,asynchronous postback和normal postback,asynchronous postback引起updatepanel的更新,normal postback引发整个页面的更新。使用scriptmanager的isinasyncpostback属性可以判断回传的类型。

  介绍一下updatepanel的属性。

  <1>triggers

  有两种asyncpostbacktrigger,postbacktrigger。
 
  asyncpostbacktrigger

  来指定某个控件的某个事件引发异步回传(asynchronous postback),即部分更新。属性有controlid和eventname。分别用来指定控件id和控件事件,若没有明确指定eventname的值,则自动采用控件的默认值,比如button就是click。把contorlid设为updatepanel外部控件的id,可以使外部控件控制 updatepanel的更新。

  postbacktrigger

  来指定updatepanel内的某个控件引发整个页面的更新(normal postback)。

code highlighting produced by actipro codehighlighter (freeware)
http://www.codehighlighter.com/

--><triggers>
            <asp:postbacktrigger controlid="button1"/>
            <asp:asyncpostbacktrigger controlid="button2" eventname="click" />
</triggers>
  <2>updatemode

  有两个值:always,conditional。总是更新,有条件更新。

  确定当asynchronous postbacks发生时,是否总是更新。若页面中只有一个updatepanel控件,这个值好像没有什么意义。但是当页面中存在多个 updatepanel,或者updatepanel中包含updatepanel的复杂情况时,这个值的设定就可以使各个updatepanel在各种合适时机更新。
 
  <3>childerastriggers
  bool值,默认是true。若设为false,则updatepanel的子控件引发异步回传(asynchronous postback),但是不更新当前updatepanel(在多个updatepanel的页面中发现的)。这里比较难于理解,甚至我理解的是错误的。请高手指点。

  该属性只在updatemode=conditional条件下有意义。右updatemode为always,childerastriggers=false就则引发异常。

  另外updatepanel还提供了一个方法update(),可以通过代码控件部分更新。

  下面给个代码,使用了这些属性。

<%@ page language="c#" %>
<!doctype html public "-//w3c//dtd xhtml 1.0 transitional//en" "http://www.w3.org/tr/xhtml1/dtd/xhtml1-transitional.dtd">
<script runat="server">

    protected void button4_click(object sender, eventargs e)
    {
        updatepanel1.update();
    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>untitled page</title>
    <style type="text/css">
    .updatepaneltitle
    {
    color:red;
    }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:scriptmanager id="scriptmanager1" runat="server">
        </asp:scriptmanager>
    
      <fieldset>
      <legend class="updatepaneltitle">updatepanel控件外</legend>
      <asp:button runat="server" id="button5" text="引发常规回传" /><br />
        <asp:button runat="server" id="button1" text="引发异步回传" /><br />        
        refrest at <%=datetime.now.touniversaltime()%>
        </fieldset>
        
        <asp:updatepanel id="updatepanel1" updatemode="conditional" runat="server">
        <triggers>
        <asp:postbacktrigger controlid="button2" />
        </triggers>
        <contenttemplate>        
        <fieldset>
        <legend class="updatepaneltitle">updatepanel1</legend>
        <asp:button runat="server" id="button2" text="引发常规回传" />
        refresh at <%=datetime.now.touniversaltime()%>
        </fieldset>
        </contenttemplate>
        </asp:updatepanel>
        
        
        <asp:updatepanel id="updatepanel2"  updatemode="conditional" runat="server">
        <triggers>
        <asp:asyncpostbacktrigger controlid="button1" />
        </triggers>
        <contenttemplate>             
        <fieldset>          
        <legend class="updatepaneltitle">updatepanel2</legend>
        <asp:button runat="server" id="button3" text="inpanel2" /> 
        refresh at <%=datetime.now.touniversaltime() %><br />
               
        <asp:updatepanel id="updatepanel3" runat="server" updatemode="always">
        <contenttemplate>
        <fieldset>
        <legend class="updatepaneltitle">updatepanel3:i'm child of updatepanel2</legend>
        <asp:button runat="server" id="button4" text="inpanel3" onclick="button4_click" />
        refresh at <%=datetime.now.touniversaltime()%>
        </fieldset>
        </contenttemplate>
        </asp:updatepanel>
        </fieldset>

        </contenttemplate>
        </asp:updatepanel>
        
        <asp:updatepanel id="updatepanel4" updatemode="conditional" runat="server" childrenastriggers="false">
        <contenttemplate>        
        <fieldset>
        <legend class="updatepaneltitle">updatepanel4</legend>
        <asp:button runat="server" id="button6" text="引发常规回传,但不更新自己" />
        refresh at <%=datetime.now.touniversaltime()%>
        </fieldset>
        </contenttemplate>
        </asp:updatepanel>             
        
        </div>
    </form>
</body>
</html>