来源: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>