• ASP.NET AJAX入门系列(4):使用UpdatePanel控件(一)


    UpdatePanel可以用来创建丰富的局部更新Web应用程序,它是ASP.NET 2.0 AJAX Extensions中很重要的一个控件,其强大之处在于不用编写任何客户端脚本,只要在一个页面上添加几个UpdatePanel控件和一个ScriptManager控件就可以自动实现局部更新。通过本文来学习一下UpdatePanel简单的使用方法(第一篇)。

     

    主要内容

    1.UpdatePanel控件概述

    2.UpdatePanel工作原理

    3.ContentTemplate属性

    4.ContentTemplateContainer属性

    5.Triggers属性

     

    一.UpdatePanel控件概述

    UpdatePanel可以用来创建丰富的局部更新Web应用程序,它是ASP.NET 2.0 AJAX Extensions中很重要的一个控件,其强大之处在于不用编写任何客户端脚本,只要在一个页面上添加几个UpdatePanel控件和一个ScriptManager控件就可以自动实现局部更新。通过本文来学习一下UpdatePanel工作原理和使用方法。简单的UpdatePanel定义如下:

    <asp:UpdatePanel ID="UpdatePanel1" runat="server">

        
    <ContentTemplate>

            
    <!---->

        
    </ContentTemplate>

        
    <Triggers>

            
    <asp:AsyncPostBackTrigger />

            
    <asp:PostBackTrigger />

        
    </Triggers>

    </asp:UpdatePanel>

    UpdatePanel重要的属性如下:

    属性

    说明

    ChildrenAsTriggers

    当UpdateMode属性为Conditional时,UpdatePanel中的子控件的异步回送是否会引发UpdatePanle的更新。

    RenderMode

    表示UpdatePanel最终呈现的HTML元素。Block(默认)表示<div>,Inline表示<span>

    UpdateMode

    表示UpdatePanel的更新模式,有两个选项:Always和Conditional。Always是不管有没有Trigger,其他控件都将更新该UpdatePanel,Conditional表示只有当前UpdatePanel的Trigger,或ChildrenAsTriggers属性为true时当前UpdatePanel中控件引发的异步回送或者整页回送,或是服务器端调用Update()方法才会引发更新该UpdatePanel。

     

    二.UpdatePanel工作原理

    UpdatePanel的工作依赖于ScriptManager服务端控件(ASP.NET AJAX入门系列(2):使用ScriptManager控件)和客户端PageRequestManager类(Sys.WebForms.PageRequestManager,在后面的客户端类中会专门说到),当ScriptManager中允许页面局部更新时,它会以异步的方式回传给服务器,与传统的整页回传方式不同的是只有包含在UpdatePanel中的页面部分会被更新,在从服务端返回HTML之后,PageRequestManager会通过操作DOM对象来替换需要更新的代码片段。

    看一下官方网站提供的UpdatePanel工作原理图:

    三.ContentTemplate属性

    Contente Template标签用来定义UpdatePanel的内容,在它里面可以放任何ASP.NET元素。如果你想要使用编程的手法来控制UpdatePanel中的内容,就需要使用ContenteTemplateContainer,下面会说到,先来看一个简单的ContentTemplate的例子。

    <asp:UpdatePanel ID="UpdatePanel1" runat="server">

        
    <ContentTemplate>

            
    <asp:Calendar ID="Calendar1" ShowTitle="True" runat="server" />

            
    <div>

                Background:

                
    <br />

                
    <asp:DropDownList ID="ColorList" AutoPostBack="True" OnSelectedIndexChanged="DropDownSelection_Change"

                    runat
    ="server">

                    
    <asp:ListItem Selected="True" Value="White"> 

                    White 
    </asp:ListItem>

                    
    <asp:ListItem Value="Silver"> 

                    Silver 
    </asp:ListItem>

                    
    <asp:ListItem Value="DarkGray"> 

                    Dark Gray 
    </asp:ListItem>

                    
    <asp:ListItem Value="Khaki"> 

                    Khaki 
    </asp:ListItem>

                    
    <asp:ListItem Value="DarkKhaki"> D

                    ark Khaki 
    </asp:ListItem>

                
    </asp:DropDownList>

            
    </div>

        
    </ContentTemplate>

    </asp:UpdatePanel>

    事件代码:

    <script runat="server">

        
    void DropDownSelection_Change(Object sender, EventArgs e)

        
    {

            Calendar1.DayStyle.BackColor 
    =

                System.Drawing.Color.FromName(ColorList.SelectedItem.Value);

        }


    </script>

    四.ContentTemplateContainer属性

    如果要使用编程的手法去设置UpdatePanel中的内容,需要创建一个UpdatePanel,并且添加控件到ContentTemplateContainer,而不能直接添加控件到ContentTemplate,如果想直接设置ContentTemplate,则需要编写一个自定义的Template,并去实现位于System.Web.UI命名空间下的接口ITemplate。看一个简单的来自于官方网站的例子:

    <%@ Page Language="C#" %>

    <script runat="server">

        protected 
    void Page_Load(object sender, EventArgs e)

        
    {

            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();

        }


    </script>

    <html xmlns="http://www.w3.org/1999/xhtml">

    <head id="Head1" runat="server">

        
    <title>UpdatePanel Added Programmatically Example</title>

    </head>

    <body>

        
    <form id="form1" runat="server">

            
    <div>

                
    <asp:ScriptManager ID="TheScriptManager"

                                   runat
    ="server" />

            
    </div>

        
    </form>

    </body>

    </html>


    五.Triggers属性

    在ASP.NET AJAX中有两种Triggers:分别为AsyncPostBackTrigger和PostBackTrigger,AsyncPostBackTrigge用来指定某个服务器端控件以及其将触发的服务器端事件作为该UpdatePanel的异步更新触发器,它需要设置的属性有控件ID和服务端控件的事件;PostBackTrigger用来指定在UpdatePanel中的某个服务端控件,它所引发的回送不使用异步回送,而仍然是传统的整页回送。这一点跟Atlas有很大的区别,大家需要注意。看一个小例子,虽然两个Button都放在了UpdatePanel中,但是由于在PostBackTrigger中指定了Button2,所以它使用的仍然是整页回送。

    <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default2.aspx.cs" Inherits="Default2" %>

    <script runat="server">

        
    void Button1_Click(object sender, EventArgs e)

        
    {
            
    this.Label1.Text = "更新时间:" + System.DateTime.Now.ToString();
        }


        
    void Button2_Click(object sender, EventArgs e)

        
    {
            
    this.Label1.Text = "更新时间:" + System.DateTime.Now.ToString();
        }


    </script>

    <html xmlns="http://www.w3.org/1999/xhtml" >

    <head runat="server">

        
    <title>UpdatePanel Trigger Sample</title>

    </head>

    <body>

        
    <form id="form1" runat="server">

        
    <div>

            
    <asp:ScriptManager ID="ScriptManager1" runat="server">

            
    </asp:ScriptManager>

        
    </div>

            
    <asp:UpdatePanel ID="UpdatePanel1" runat="server">

                
    <ContentTemplate>

                    
    <div>

                        
    <asp:Button ID="Button1" runat="server" Text="异步回送" OnClick="Button1_Click"/>&nbsp;&nbsp;

                        
    <asp:Button ID="Button2" runat="server" Text="整页回送" OnClick="Button2_Click"/><br />

                        
    <br />

                        
    <asp:Label ID="Label1" runat="server" Text="当前时间" Font-Bold="True" Font-Size="Large"></asp:Label></div>

                
    </ContentTemplate>

                
    <Triggers>

                    
    <asp:AsyncPostBackTrigger ControlID="Button1"/>

                    
    <asp:PostBackTrigger ControlID="Button2" />

                
    </Triggers>

            
    </asp:UpdatePanel>

        
    </form>

    </body>

    </html>
  • 相关阅读:
    linux一行执行多条命令 shell
    创建右键nushell打开UTF8(似乎需要win10 1803版本以上,admin的不需要)
    uniapp零碎总结
    nginx https配置问题
    ElasticSearch随记
    ElasticSearch修改index增加字段
    分区表创建和查询
    netfinal
    Mysql 命令操作
    【2022.06.23】python连接数据库
  • 原文地址:https://www.cnblogs.com/zhuawang/p/2012650.html
Copyright © 2020-2023  润新知