通过

Button Web 服务器控件声明性语法

  • 项目

更新：2007 年 11 月

在 Web 窗体页上显示下压按钮 (Button) 控件。

<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 窗体页上创建下压按钮。可以创建两种类型的按钮：submit 按钮或 command 按钮。

默认情况下，Button 控件是一个 submit 按钮。submit 按钮没有与按钮关联的命令名（由 CommandName 属性指定），它只是将网页发送回服务器。可以为 Click 事件提供事件处理程序，以编程方式控制单击 submit 按钮时执行的操作。

通过设置 CommandName 属性，command 按钮将命令名与按钮相关联（如 Sort）。这使您能够在 Web 窗体页上创建多个 Button 控件，并在 Command 事件的事件处理程序中以编程方式确定要单击的 Button 控件。也可以对 command 按钮使用 CommandArgument 属性以提供有关要执行的命令（如 Ascending）的附加信息。可以为 Command 事件提供事件处理程序，以编程方式控制单击 command 按钮时执行的操作。

模板化控件中经常使用 Command 按钮，它将操作传送给父控件，例如，在 DataList 进行选择或在 FormView 中更改模式。

默认情况下，在单击 Button 控件时执行页验证。页验证确定与该页上验证控件关联的输入控件是否通过该验证控件指定的验证规则。如果 Button 控件需要禁用此行为（如 reset 按钮），请将 CausesValidation 属性设置为 false。

说明：

由于 <asp:Button> 元素没有内容，所以可以用 /> 结束该标记，而不是使用单独的结束标记。

若要指定 Button 控件中显示的标题，请设置 Text 属性。

有关 Button 控件的属性和事件的详细信息，请参见 Button 文档。

示例

下面的示例演示如何在 .aspx 文件中声明 submit 按钮控件。

<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"/>

下面的示例演示如何在 .aspx 文件中声明 command 按钮控件。

<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 服务器控件语法