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 控件内。显示两个按钮：Button1 和 Button2。 Button1 刷新面板的内容，Button2 刷新整个页面。

<%@ 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 控件的内容。第一个示例显示使用该用户控件的页面。第二个示例显示该用户控件。

<%@ 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

<%@ 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