HtmlForm.DefaultButton 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定 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, setPublic 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 控件不是衍生自 IButtonControl， InvalidOperationException 則會擲回例外狀況。
如果您使用主版頁面，並從內容頁面設定 DefaultButton 屬性，請使用 UniqueID 按鈕的 IButtonControl 屬性。 如需主版頁面的詳細資訊，請參閱 ASP.NET 主版頁面。
屬性 DefaultButton 可能不會在下列案例中造成回傳：
當焦點位於表單的輸入控件外部時，按 ENTER 鍵。 默認回傳動作不保證會觸發。
當焦點位於多行文本框內時，按 ENTER 鍵。 在多行文本框中，預期的行為是按 ENTER 會在文字框中建立新行。 在某些瀏覽器中，按多行文本框中的 ENTER 會觸發回傳。 在此情況下，如果您想要改為讓 ENTER 建立新行，您可以將 JavaScript 函式附加至輸入控件。 腳本應該會擷取 ENTER 鍵並停止回傳。 例如，您可以使用 Attributes 屬性集合來新增事件的用戶端腳本
onKeyPress。將 LinkButton 控件指定為預設按鈕。 僅 Button 支援和 ImageButton 控制件。
在異步回傳期間以程序設計方式變更 DefaultButton 屬性。 您可以在頁面上啟用異步回傳，方法是將一或多個 UpdatePanel 控件新增至頁面。 如需詳細資訊，請參閱 UpdatePanel控件概觀 和 部分頁面轉譯概觀。
