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