ScriptManager.RegisterAsyncPostBackControl 方法

来源:VS2012帮助文档

用途:

将控件注册为异步回发的触发器

语法:

public void RegisterAsyncPostBackControl(

    Control control

)

参数

control
类型: System.Web.UI. Control
要为异步回发注册的控件

备注:

使用 RegisterAsyncPostBackControl 方法可将 Web 服务器控件注册为触发器,以使其执行异步回发而不是同步回发。 UpdatePanel 控件的 ChildrenAsTriggers 属性设置为 true(默认值)时, UpdatePanel 控件内的回发控件会自动注册为异步回发控件。

使用 RegisterAsyncPostBackControl 方法可将 UpdatePanel 控件外部的控件注册为异步回发的触发器,并可能会对更新面板的内容进行更新。 若要以编程方式更新 UpdatePanel 控件,请调用 Update 方法。

可以使用 UpdatePanel 控件的 Triggers 元素,以声明方式添加触发器。 在 Visual Studio 2010 中,使用设计器的“UpdatePanelTrigger 集合编辑器”对话框。

示例

(1)下面的示例演示如何调用 RegisterAsyncPostBackControl 方法来注册 Button 控件,以便更新 UpdatePanel 控件的内容。 Button 控件不在 UpdatePanel 控件内。 显示两个按钮:Button1Button2 Button1 刷新面板的内容,Button2 刷新整个页面。

ScriptManager.RegisterAsyncPostBackControl 方法
<%@ 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 Page_Load(object sender, EventArgs e)

    {

        ScriptManager1.RegisterAsyncPostBackControl(Button1);

    }



    protected void Button1_Click(object sender, EventArgs e)

    {

        Label1.Text = "Panel refreshed at " + DateTime.Now.ToString();

    }

    protected void Button2_Click(object sender, EventArgs e)

    {

        Label1.Text = "Page refreshed.";

    }

</script>

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

<head runat="server">

    <title>ScriptManager RegisterAsyncPostBackControl Example</title>

</head>

<body>

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

        <div>

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

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

        <ContentTemplate>

        <fieldset>

        <legend>Update Panel</legend>

        <asp:Label ID="Label1" runat="server">Initial postback occurred.</asp:Label>

        </fieldset>

        </ContentTemplate>

        </asp:UpdatePanel>

        <asp:Button ID="Button1" runat="server" Text="Update Panel" OnClick="Button1_Click" />

        <asp:Button ID="Button2" runat="server" Text="Refresh Page" OnClick="Button2_Click" />

        </div>

    </form>

</body>

</html>
View Code

(2)下面的示例演示如何调用 RegisterAsyncPostBackControl 方法来注册用户控件,以便更新 UpdatePanel 控件的内容。 第一个示例显示使用该用户控件的页面。 第二个示例显示该用户控件。

ScriptManager.RegisterAsyncPostBackControl 方法
<%@ Page Language="C#" %>



<%@ Register Src="Controls/WebUserControl.ascx" TagName="WebUserControl"

    TagPrefix="uc1" %>



<!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 Page_Load(object sender, EventArgs e)

    {

        ScriptManager1.RegisterAsyncPostBackControl(WebUserControl1);

    }



    protected void Button1_Click(object sender, EventArgs e)

    {

        Label1.Text = "Panel refreshed at " + DateTime.Now.ToString();

    }



    protected void WebUserControl1_Click(object sender, EventArgs e)

    {

        Label1.Text = "Panel refreshed at " + DateTime.Now.ToString() +

            ".  Welcome " + WebUserControl1.Name + ". ";

    }



</script>



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

<head runat="server">

    <title>ScriptManager RegisterAsyncPostBackControl Example</title>

</head>

<body>

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

        <div>

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

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

                <ContentTemplate>

                    <fieldset>

                        <legend>Update Panel</legend>

                        <asp:Label ID="Label1" runat="server">Initial postback occurred.</asp:Label>

                    </fieldset>

                </ContentTemplate>

            </asp:UpdatePanel>

            <asp:Button ID="Button1" runat="server" Text="Update Panel" OnClick="Button1_Click" />

            <uc1:webusercontrol id="WebUserControl1" runat="server" oninnerclick="WebUserControl1_Click" />

        </div>

    </form>

</body>

</html>
View Code
ScriptManager.RegisterAsyncPostBackControl 方法
<%@ Control Language="C#" ClassName="WebUserControl" %>



<script runat="server">

    public event EventHandler InnerClick

    {

        add

        {

            UCButton1.Click += value;

        }

        remove

        {

            UCButton1.Click -= value;

        }

    }

    public String Name

    {

        get

        {

            return UCTextBox1.Text;

        }

    }

</script>



<asp:Panel ID="UCPanel1" runat="server" GroupingText="User Control">

    Enter your name:

    <asp:TextBox ID="UCTextBox1" runat="server"></asp:TextBox>

    <br />

    <asp:Button ID="UCButton1" runat="server" Text="Submit" />

</asp:Panel>
View Code

你可能感兴趣的:(manager)