ASP.Net UpdatePanel控件(转)

时间:2023-03-09 05:25:07
ASP.Net UpdatePanel控件(转)
  Asp.net UpdatePanel 允许用户构建一个丰富的,以客户端为中心的应用程序,引用UpdatePanel控件,能够实现页面的部分刷新,一个包含scriptManage和 UpdatePanel控件的页面自动具有页面部分刷新的功能,不需要写任何的客户端JavaScript代码。一个web页面只能包含一个 ScriptManage控件,但可以包含一个或多个UpdatePanel控件。

使用UpdatePanel控件实现页面的局部更新,需要包含一个ScriptManage控件,并且必须将ScriptManage控件的 EnablePartialRendering属性设置为true,不过你不用担心,该属性的默认值就是True,所以,在默认情况下,只要添加了 ScriptManage控件,该页面就自动具有了局部更新的能力。

下面,我们来看看页面中UpdatePanel的几种用法:

一、一般用法:下面的代码展示了一个包含了一个Button控件的UpdatePanel控件的一般用法,因为UpdatePanel控件的ChildAsTriggers属性默认值为ture,所以,当我们点击这个Button按钮时将引发一个异步回传。

           

二、为UpdatePanel控件指定一个Trigger:默认情况下,UpdatePanel控件内部的任何控件引发的PostBack都是异步 PostBack,同时实现页面的局部更新,当然,你也可以去配置一个其他的控件去刷新一个UpdatePanel,这时,你需要设置 UpdatePanel的Trigger属性,一个Trigger将被绑定到指定的控件,当这个控件引发postback时,将异步刷新这个 UpdatePanel,当然,这个被Trigger指定的控件不必在该UpdatePanel内。请看如下代码:

             

在UpdatePanel的Trigger元素里,我们定义了一个<asp:AsyncPostBackTrigger>
元素,该元素的ControlID
属性指定了引发Trigger的控件ID,EventName属性指定了引发PostBack的事件名称,若未指定该属性,将使用该控件的默认事件(例如:在Button控件中,默认事件为Click事件)。另,以上设置都可以在VS2005属性设计器中可视化的设置。

三、Master Page中的UpdatePanel:在Master Page中使用UpdatePanel,你必须决定如何包含ScriptManage控件,有以下两种策略在页面上来包含ScriptManger控件,1.将ScriptManage控件放置在Masert Page中,这样,它将作用于所有内容页。如果你想在内容页去注册脚本货服务,你可以在内容页添加一个ScriptManagerProxy
控件。2.将ScriptManage控件放置在每个包含UpdatePanel的内容页上。使用何种策略,取决于你将在你的应用程序中以何种方式管理你的脚本。

如果以策略一的方式包含了ScriptManage控件,但你在某个内容页面上又不想实现局部更新,那么,你就必须在该页面以编程的方式设置ScriptManage控件的 EnablePartialRendering
属性为false。下面代码展示了以策略一的方式使用UpdatePanel的情况:
Master Page:

         {
             return (DateTime)(ViewState["LastUpdate"] ?? DateTime.Now);
         }
         set
         {
             ViewState["LastUpdate"] = value;
         }
     }
 
 
     protected void MasterButton2_Click(object sender, EventArgs e)
     {
         LastUpdate = DateTime.Now;
         ((UpdatePanel)ContentPlaceHolder1.FindControl("UpdatePanel1")).Update();
 
     }
 
     protected void Page_Load(object sender, EventArgs e)
     {
         ScriptManager1.RegisterAsyncPostBackControl(Button2);
     }
                     

Content Page:

         Master.LastUpdate = DateTime.Now;
     }
 
                        </asp:Content>

四、UpdatePanel的嵌套:UpdatePanel能够嵌套使用,在这种情况下,若父Panel被刷新,那么,所有的子Panel也将被刷新。请看如下代码:

                                  

五:以编程方式刷新UpdatePanel:

             

在以上代码中,页面调用ScriptManager1.RegisterAsyncPostBackControl(SurveyDataList);
方法注册了一个能够引发Trigger的控件,调用Update()方法实现了Updatepanel的刷新。

六:以编程方式创建UpdatePanel:你能够以编程的方式创建一个UpdatePanel的实例,并且可以使用它的ContentTemplateContainer
属性和Add(control)方法为该Panel添加内容,请看如下代码。

         UpdatePanel up1 = new UpdatePanel();
         up1.ID = "UpdatePanel1";
         up1.UpdateMode = UpdatePanelUpdateMode.Conditional;
         Button button1 = new Button();
         button1.ID = "Button1";
         button1.Text = "Submit";
         button1.Click += new EventHandler(Button_Click);
         Label label1 = new Label();
         label1.ID = "Label1";
         label1.Text = "A full page postback occurred.";
         up1.ContentTemplateContainer.Controls.Add(button1);
         up1.ContentTemplateContainer.Controls.Add(label1);
         Page.Form.Controls.Add(up1);
 
     }
     protected void Button_Click(object sender, EventArgs e)
     {
         ((Label)Page.FindControl("Label1")).Text = "Panel refreshed at " +
             DateTime.Now.ToString();
     }
 
                

由于UpdatePanel的ChildrenAsTriggers的默认属性为True,所以,在该示例中,Button控件将引发Panel的Trigger。

参考文档:http://ajax.asp.net/docs/overview/UpdatePanelOverview.aspx

以上文档是我对asp.net ajax一个官方文档的....,不能说翻译吧,毕竟,我的E文水平是要借助金山词霸才能看懂的,算是自我的一个理解吧,也正因为我E文水平有限,很多疏漏,错误,和理解不正确的地方,还请大家不吝指出哈,我也是一个Ajax新手,非常希望得到你的指点。