ScriptManager和UpdatePanel用法 (ajax) - BlueWorl...

来源:百度文库 编辑:神马文学网 时间:2024/04/29 15:14:08

ScriptManager和UpdatePanel控件联合使用可以实现页面异步局部更新的效果。其中的UpdatePanel就是设置页面中异步局部更新区域,它必须依赖于ScriptManager存在,因为ScriptManger控件提供了客户端脚本生成与管理UpdatePanel的功能。
几个重要的属性:
    ScriptManager控件的EnablePartialRendering属性:true-实现页面的异步局部更新;false-实现全页面的刷新。
    UpdatePanel控件的RenderMode属性:InLine-UpdatePanel控件被解析成HTML的标记;Block-UpdatePanel控件被解析成HTML控件的


    UpdatePanel控件的UpdateMode属性:Always-UpdatePanel页面上任何一处发生的回发操作都会产生页局部更新;Conditional-只在特定的情况下才产页面的回发,如执行UpdatePanel控件的update()方法或在指定的触发器的操作下。
    UpdatePanel控件的ChildAsTrigger属性:指示UpdatePanel内部控件引起的回发是否产生当前UpdatePanel控件的局部更新。如果UpdateMode设为Always的话,那ChildAsTrigger局性必须设为True,否则运行出错。

一、UpdatePanel内部的控件引起的回发,来更新当前UpdatePanel内部的控件内容:
    1.向页面中加入ScriptManager、UpdatePanel控件和一个Label控件(Label2)。
    2.在UpdatePanel中加入一个Button、一个Label(Label1)。
    3.双击Button在事件处理程序中写入下列代码:Label1.Text = DateTime.Now.ToString();
    4.在Page_Load事件中写入下列代码:Label2.Text = DateTime.Now.ToString();
    5.运行页面,发现每次点击按钮都会产生异步局步刷新,只有Label1的内容发生更改,页面上的Label2时间没有发生更改。
   
    代码如下:
       
       
       

        ChildrenAsTriggers="True">
           
               
               

                Click="Button1_Click" Text="Button" />
           

       

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

       注意:此时的ScriptManager的EnablePartialRendering属性应设为true。UpdatePanel的UpdateMode属性应设为Always。ChildAsTrigger属性应设为true。

二、UpdatePanel控件外部的控件引起的回发,来异步更新UpdatePanel内部的内容:
    虽然上面的方式能够很简单地实现异步局部更新的功能,但就性能方面考虑,我们应当只将数据确实会发生变化的控件摆放在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,如果还是Always的话,会出现所有的UpdatePanel都刷新的效果。
    3、触发器
        如果页面上有多个UpdatePanel控件,如果要实现外部的控件的回发引发指定UpdatePanel的更新的话,那应当为要实现刷新的UpdatePanel控件建立一个触发器。
       a.选中要进行局部更新的UpdatePanel控件。
       b.在其属性页中点击Triggers集合属性右边的小按钮。
       c.在弹出的对话框中,的成员列表中添加一个AsyncPostBackTriggers成员。
       d.指定AsyncPostBackTriggers成员的ControlID和EventName,即引发异步回送的控件的ID和该控件的事件。
       完成以上步骤后,切换到HTML页面就会出现下列代码:
           
               
                   
               

               
                    ControlID="Button2" EventName="Click"
/>
               

           
            Click="Button2_Click" Text="ButtonOut" />
        这里需要大家注意的是:
           把所有的UpdatePanel控件的UpdateMode设为"Conditional",这样才能够针对建有相关触发器的UpdatePanel更新。
           一个UpdatePanel上可以建有多个触发器,实现在不同的情况下对该UpdatePanel控件内容的更新。

          
三、两个UpdatePanel控件,其中一个UpdatePanel内的控件引发两个UpdatePanel控件的同时刷新。
    a.在页面上放入两个UpdatePanel和一个ScriptManager控件。
    b.在UpdatePanel1中加入一个标签Label1、一个按钮Button1 ,在UpdatePanel2中加入一个标签Label2。
    c.将UpdatePanel1和UpdatePanel2两个控件的的UpdateMode属性设为"Always"
    c.在Button1的Click事件中加入下面的代码:
        protected void Button1_Click(object sender, EventArgs e)
        {
            Label1.Text = DateTime.Now.ToString();
            Label2.Text = DateTime.Now.ToString();
        }
   
四、两个UpdatePanel控件,其中一个UpdatePanel内的控件引发当前的UpdatePanel控件的刷新,而另一个不刷新。
    a.步骤和上面的(三)一样
    b.要把UpdatePanel1和UpdatePanel2两个控件的UpdateMode属性设为Conditional   
           
           

            UpdateMode="Conditional">
               
                   
                   

                    Click="Button1_Click1" Text="更新两个UpdatePanel" />
               

           

            UpdateMode="Conditional">
               
                   
               

           

五、两个UpdatePanel控件,其中一个UpdatePanel内的控件引发另一个UpdatePanel控件的刷新,而本身不刷新。
    a.步骤和上面的(四)一样
    b.把UpdatePanel1和UpdatePanel2的ChildrenAsTriggers属性设为false
    c.在UpdatePanel2控件中加入一个触发器,触发源设到UpdatePanel1控件内的Button1的Click事件上。
           
           

            UpdateMode="Conditional" ChildrenAsTriggers="False">
               
                   
                   

                    Click="Button1_Click1" Text="更新两个UpdatePanel" />
               

           

            UpdateMode="Conditional">
               
                   
               

               
                    ControlID="Button1" EventName="Click"
/>
               
           

在开发过程中难免会用到UpdatePanel控件的一些复杂的使用。如:UpdatePanel控件的嵌套、在母版页中使用UpdatePanel、在用户控件中使用UpdatePanel以及在GridView中使用UpdatePanel等。
其实这些操作也免不了对UpdatePanel控件的UpdateMode属性、ChildrenAsTrigger属性以及触发器的使用,下面是系统地说明。


一、两个嵌套的UpdatePanel控件,外部的UpdatePanel内的控件回发引发二者同时更新
    在页面上放一个ScriptManager和UpdatePanel控件(UpdatePanel1),在UpdatePanel1中放入一个标签控件(lblOut)、一个按钮(Button1)和另一个UpdatePanel控件(UpdatePanel2),在UpdatePanel2控件中放一个标签控件lblIn。
      


           
           

            UpdateMode="Conditional"
>
               
                   
                    Click="Button1_Click2" Text="Button" />
                    <asp:UpdatePanel ID="UpdatePanel2" runat="server" UpdateMode="Conditional">
                       
                           
                       

                   
               

           
    在Button1控件中的Click事件中加入下面的代码:
    protected void Button1_Click2(object sender, EventArgs e)
    {
        lblIn.Text = DateTime.Now.ToString();
        lblOut.Text = DateTime.Now.ToString();
    }

    要实现外部UpdatePanel内控件的回发引起内部和外部两个UpdatePanel控件的同时刷新的话,需要把两个UpdatePanel控件的UpdateMode都设为Conditional,这样外部UpdatePanel内的控件回发会自动引起内部UpdatePanel控件的刷新。
    注意:
        外部UpdatePanel控件的ChildrenAsTrigger属性要设为True,两个UpdatePanel控件的UpdateMode要都设为Conditional,如果UpdateMode设为Always的话也会出现两个UpdatePanel同时刷新的效果,但样这会导致页面上其它的UpdatePanel控件也发生刷新。
              
二、两个嵌套的UpdatePanel控件,内部的UpdatePanel内的控件回发引发二者同时更新
    在页面上放一个ScriptManager和UpdatePanel控件(UpdatePanel1),在UpdatePanel1中放入一个标签控件(lblOut)和另一个UpdatePanel控件(UpdatePanel2),在UpdatePanel2控件中放一个标签控件lblIn和一个按钮(Button1)。
   


           
           

            UpdateMode="Conditional"
>
               
                   
                   

                    UpdateMode="Conditional">
                       
                           
                    Click="Button1_Click2" Text="Button" />
                       

                   

               

               
                   
               

           
    在按钮的Click事件中和(一)中的一样。
    注意:
       把两个UpdatePanel控件的UpdateMode属性设为Conditional,要把内部控件ChildrenAsTrigger设为True。但这样内部UpdatePanel内的控件只引发自身的刷新,不会引发外部的UpdatePanel控件的刷新,不会刷新外部的UpdatePanel控件,因此我们还需要为外部UpdatePanel控件加入一个触发器,触发源指定为Button1控件的Click事件上。

       
三、两个嵌套的UpdatePanel控件,外部的UpdatePanel内的控件回发只引发内部控件的更新
    在页面上放一个ScriptManager和UpdatePanel控件(UpdatePanel1),在UpdatePanel1中放入一个标签控件(lblOut)、一个按钮(Button1)和另一个UpdatePanel控件(UpdatePanel2),在UpdatePanel2控件中放一个标签控件lblIn。
   


           
           

            UpdateMode="Conditional"
ChildrenAsTriggers="False">
               
                   
                    Click="Button1_Click2" Text="Button" />

                    UpdateMode="Conditional">
                       
                             
                       

                       
                           
                       

                   

               

           
           在按钮的Click事件中和(一)中的一样。
    注意:
        要把两个UpdatePanel控件的UpdateMode设为Conditional,把外部UpdatePanel控件的ChildrenAsTrigger设为false。这样两个UpdatePanel控件都不会刷新,所以还要为内部的UpdatePanel控件建立触发器,触发源指向外部UpdatePanel中的的Button1的Click事件上。

       
四、母版页中使用UpdatePanel控件
    如果将ScriptManager控件添加在母版页上的话,那么各内容页面就没必要再添加ScriptManager控件了,只需添加UpdatePanel控件就可以了,因为母版页和内容页面将来生成的是一个页面的实例,而在一个页面上是不允许同时存在两个ScriptManager控件的。
    如果ScriptManager控件没有添加在母版页上的话,那只能把ScriptManager控件添加在其中一个内容页面里。不要向每一个内容页面中添加ScriptManager控件。
    1、内容页面中的UpdatePanel内的控件引起回发,只更新当前内容页面的内容。
   


        此时按钮分别在各自的UpdatePanel控件内。
        将两个内容页面内的两个UpdatePanel控件的UpdateMode设为Conditional,ChildrenAsTrigger设为True。
        在按钮的Click事件中和(一)中的一样。
        这样就出现各内容页的UpdatePanel内的按钮只对当前内容页起作用。
    2、在母版页中的按钮引起回发,更新指定内容页的信息。
       


       此时有两个按钮:ButtonOuter在母版页中,ButtonInner在内容页面1中。
       当点击ButtonOuter时,异步更新两个内容页面的信息。当点击ButtonInner时,异步更新母版面中的UpdatePanel1中的信息。
       母版页HTML代码如下:
      


     母版页3
       

    
        
            
        

    

      

     Click="Button1_Click" Text="ButtonOuter" />

     #####################################################################
    
           
               
               
           
       

       
       

               

                   
                   

               

       

       

       内容页面的HTML代码如下:
       <%@ Page Language="C#" MasterPageFile="~/MasterPage3.master" AutoEventWireup="true" CodeFile="Child3.aspx.cs" Inherits="Child3" Title="Untitled Page" %>
        <%@ MasterType VirtualPath="~/MasterPage3.master" %>
       
           
               
                   
            Click="Button1_Click" Text="ButtonInner" />
               

           

       

       
           
               
                   
               

           

       

       母版页的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 TitleInfo
        {
            get
            {
                return lbl.Text;
            }
            set
            {
                lbl.Text = value;
            }
        }

       内容页面的CS代码如下:
        protected void Button1_Click(object sender, EventArgs e)
        {
            Label1.Text = Master.TitleInfo;
            Master.TitleInfo = "ContentPage1's Action";
            ((UpdatePanel)Master.FindControl("UpdatePanel1")).Update(); ;

        }

五、用户控件中使用UpdatePanel控件
    如果父页面中存在ScriptManager控件,那用户控件的页面中不应再放入ScriptManager控件了,只在用户控件中加入UpdatePanel。
   
    其控件的回发与更新规律与使用方式与母版页一样。