Button.UseSubmitBehavior 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个布尔值,该值指示 Button 控件使用客户端浏览器的提交机制还是 ASP.NET 回发机制。
public:
virtual property bool UseSubmitBehavior { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool UseSubmitBehavior { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.UseSubmitBehavior : bool with get, set
Public Overridable Property UseSubmitBehavior As Boolean
属性值
如果该控件使用了客户端浏览器的提交机制,则为 true
;否则为 false
。 默认值为 true
。
- 属性
示例
下面的代码示例演示如何使用 UseSubmitBehavior 属性指定控件在发回服务器时使用的提交机制 Button 。 属性 UseSubmitBehavior 设置为 false
,导致按钮使用 ASP.NET 回发机制。 如果使用浏览器的“查看源”命令查看呈现页面的源代码,则会看到 ASP.NET 页框架添加了客户端脚本,以便将表单发布到服务器。
<%@ 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">
void SubmitBtn_Click(object sender, EventArgs e)
{
Message.Text = "Hello World!";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Button.UseSubmitBehavior Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.UseSubmitBehavior Example</h3>
Click the Submit button.
<br /><br />
<!--The value of the UseSubmitBehavior property
is false. Therefore the button uses the ASP.NET
postback mechanism.-->
<asp:button id="Button1"
text="Submit"
onclick="SubmitBtn_Click"
usesubmitbehavior="false"
runat="server"/>
<br /><br />
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
Message.Text = "Hello World!"
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Button.UseSubmitBehavior Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.UseSubmitBehavior Example</h3>
Click the Submit button.
<br /><br />
<!--The value of the UseSubmitBehavior property
is false. Therefore the button uses the ASP.NET
postback mechanism.-->
<asp:button id="Button1"
text="Submit"
onclick="SubmitBtn_Click"
usesubmitbehavior="false"
runat="server"/>
<br /><br />
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
注解
UseSubmitBehavior使用 属性指定控件是使用客户端浏览器的提交机制还是 Button ASP.NET 回发机制。 默认情况下,此属性 true
的值为 ,导致 Button 控件使用浏览器的提交机制。 如果指定 false
,ASP.NET 页框架会将客户端脚本添加到页面,以将表单发布到服务器。
UseSubmitBehavior当 属性为 false
时,控件开发人员可以使用 GetPostBackEventReference 方法返回 的Button客户端回发事件。 方法返回的 GetPostBackEventReference 字符串包含客户端函数调用的文本,可以插入到客户端事件处理程序中。
无法通过主题或样式表主题设置此属性。 有关详细信息,请参阅 ThemeableAttribute 和 ASP.NET 主题和外观。