Share via

Button Web 伺服器控制項宣告式語法

  • 發行項

更新：2007 年 11 月

在 Web Form 網頁上顯示按鈕控制項。

 <asp:Button     AccessKey="string"     BackColor="color name|#dddddd"     BorderColor="color name|#dddddd"     BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|         Inset|Outset"     BorderWidth="size"     CausesValidation="True|False"     CommandArgument="string"     CommandName="string"     CssClass="string"     Enabled="True|False"     EnableTheming="True|False"     EnableViewState="True|False"     Font-Bold="True|False"     Font-Italic="True|False"     Font-Names="string"     Font-Overline="True|False"     Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|         Large|X-Large|XX-Large"     Font-Strikeout="True|False"     Font-Underline="True|False"     ForeColor="color name|#dddddd"     Height="size"     ID="string"     OnClick="Click event handler"     OnClientClick="string"     OnCommand="Command event handler"     OnDataBinding="DataBinding event handler"     OnDisposed="Disposed event handler"     OnInit="Init event handler"     OnLoad="Load event handler"     OnPreRender="PreRender event handler"     OnUnload="Unload event handler"     PostBackUrl="uri"     runat="server"     SkinID="string"     Style="string"     TabIndex="integer"     Text="string"     ToolTip="string"     UseSubmitBehavior="True|False"     ValidationGroup="string"     Visible="True|False"     Width="size" />

備註

Button 控制項可以讓您在 Web Form 網頁上建立按鈕。您可以建立兩種類型的按鈕：submit 按鈕或 command 按鈕。

根據預設，Button 控制項會是 submit 按鈕。submit 按鈕沒有與按鈕關聯的命令名稱 (由 CommandName 屬性所指定)，而只是將 Web 網頁回傳至伺服器。您可以提供 Click 事件的事件處理常式，以程式的方式控制在按一下 [submit] 按鈕時執行的動作。

command 按鈕具有藉由設定 CommandName 屬性而與按鈕關聯的命令名稱 (例如 Sort)。這樣可以讓您在 Web Form 網頁上建立多個 Button 控制項，並在 Command 事件的事件處理常式中以程式設計方式判斷是哪一個 Button 控制項被按一下。您也可以將 CommandArgument 屬性與 command 按鈕搭配使用，以提供所要執行命令 (例如 Ascending) 的其他資訊。您可以提供 Command 事件的事件處理常式，以程式的方式控制在按一下 [command] 按鈕時執行的動作。

Command 按鈕通常會在樣板化控制項中使用，以便將動作傳送至父控制項，例如 DataList 中的選取範圍，或是在 FormView 中變更模式。

根據預設，按一下 Button 控制項時便會執行網頁驗證。網頁驗證會判斷網頁上與驗證控制項關聯的輸入控制項，是否通過驗證控制項所指定的驗證規則。如果 Button 控制項必須停用這個行為 (例如 [reset] 按鈕)，請將 CausesValidation 屬性設為 false。

注意事項：

由於 <asp:Button> 項目沒有內容，所以您可以使用 /> 結束標記，而不必使用個別的結尾標記。

若要指定顯示在 Button 控制項中的標題，請設定 Text 屬性。

如需 Button 控制項之屬性和事件的詳細資訊，請參閱 Button 文件。

範例

下列範例會示範 submit 按鈕控制項在 .aspx 檔案中的宣告。

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"  />

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"/>

下列範例會示範 command 按鈕控制項在 .aspx 檔案中的宣告。

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

下列範例會示範事件處理方法，讓按鈕按一下並顯示從按鈕的 CommandName 和 CommandArgument 屬性中所傳遞的資訊。

Sub CommandBtn_Click(ByVal sender As Object, ByVal e As CommandEventArgs)
    Message.Text = "You clicked the " & e.CommandName & _
                   " - " & e.CommandArgument & " button."
End Sub

void CommandBtn_Click(Object sender, CommandEventArgs e)
{
    Message.Text = "You clicked the " + e.CommandName +
                   " - " + e.CommandArgument + " button.";
}

請參閱

參考

Button

其他資源

Web 伺服器控制項語法