Button.UseSubmitBehavior 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定值，指出 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

屬性值

Boolean

如果控制項使用用戶端瀏覽器的送出機制則為 true，否則為 false。 預設為 true。

屬性
ThemeableAttribute

範例

下列程式碼範例示範如何使用 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 主題和麵板。

適用於

另請參閱