共用方式為


Button.UseSubmitBehavior 屬性

定義

取得或設定值,指出 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 回的字串包含用戶端函式呼叫的文字,而且可以插入用戶端事件處理程式中。

這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊,請參閱 ThemeableAttributeASP.NET 主題和面板

適用於

另請參閱