共用方式為


HtmlForm.DefaultButton 屬性

定義

取得或設定 HtmlForm 控制項的子控制項,它會在按下 ENTER 鍵時引發回傳。

public:
 property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };
public string DefaultButton { get; set; }
member this.DefaultButton : string with get, set
Public Property DefaultButton As String

屬性值

載入 ID 時,顯示為預設按鈕的按鈕控制項 HtmlForm。 預設值為空字串 ("")。

例外狀況

當做預設按鈕參考的控制項不是 IButtonControl 型別。

範例

下列範例示範如何設定 DefaultButton 屬性,以設定造成回傳的預設控件。

<%@ 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 Page_Load(object sender, System.EventArgs e)
  {
    
    // Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to "
                + Form1.DefaultButton.ToString() + "<br/>";
    Label2.Text = "The DefaultFocus property is set to "
                + Form1.DefaultFocus.ToString();
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </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 Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    ' Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to " _
                  & Form1.DefaultButton.ToString & "<br/>"
    Label2.Text = "The DefaultFocus property is set to " _
                  & Form1.DefaultFocus.ToString
  End Sub
     
 </script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </form>

</body>

</html>

備註

屬性 DefaultButton 可讓您指定使用者可以在表單中的輸入控制項中按 ENTER 來產生回傳 (,例如文字框) 。 您可以將 指定為預設按鈕,任何衍生自 介面的 IButtonControl 控件,但控件除外 LinkButton 。 如果 屬性所參考的 DefaultButton 控件不是衍生自 IButtonControlInvalidOperationException 則會擲回例外狀況。

如果您使用主版頁面,並從內容頁面設定 DefaultButton 屬性,請使用 UniqueID 按鈕的 IButtonControl 屬性。 如需主版頁面的詳細資訊,請參閱 ASP.NET 主版頁面

屬性 DefaultButton 可能不會在下列案例中造成回傳:

  • 當焦點位於表單的輸入控件外部時,按 ENTER 鍵。 默認回傳動作不保證會觸發。

  • 當焦點位於多行文本框內時,按 ENTER 鍵。 在多行文本框中,預期的行為是按 ENTER 會在文字框中建立新行。 在某些瀏覽器中,按多行文本框中的 ENTER 會觸發回傳。 在此情況下,如果您想要改為讓 ENTER 建立新行,您可以將 JavaScript 函式附加至輸入控件。 腳本應該會擷取 ENTER 鍵並停止回傳。 例如,您可以使用 Attributes 屬性集合來新增事件的用戶端腳本 onKeyPress

  • LinkButton 控件指定為預設按鈕。 僅 Button 支援和 ImageButton 控制件。

  • 在異步回傳期間以程序設計方式變更 DefaultButton 屬性。 您可以在頁面上啟用異步回傳,方法是將一或多個 UpdatePanel 控件新增至頁面。 如需詳細資訊,請參閱 UpdatePanel控件概觀部分頁面轉譯概觀

適用於

另請參閱