Button (Control de servidor Web)
Muestra un control de botón de comando en la página de formularios Web Forms.
<asp:Button id="MyButton"
Text="label"
CommandName="command"
CommandArgument="commandargument"
CausesValidation="true | false"
OnClick="OnClickMethod"
runat="server"/>
Comentarios
El control Button permite crear un botón de comando en la página de formularios Web Forms. Se pueden crear dos tipos de botones. Se puede crear un botón submit o un botón command.
De manera predeterminada, un control Button es un botón submit. Un botón submit no tiene nombre de comando (especificado por la propiedad CommandName) asociado al botón y simplemente devuelve la página Web al servidor. Se puede proporcionar un controlador de eventos para el evento Click con el fin de controlar mediante programación las acciones que se realizan cuando se hace clic en el botón submit.
Un botón command tiene un nombre de comando asociado al botón (por ejemplo, Sort) si se establece la propiedad CommandName. Esto permite crear varios controles Button en una página de formularios Web Forms y determinar mediante programación en qué control Button se hace clic en el controladores de eventos del evento Command. También se puede usar la propiedad CommandArgument con un botón command para facilitar información adicional sobre el comando que se va a ejecutar, como Ascending. Se puede proporcionar un controlador de eventos para el evento Command con el fin de controlar mediante programación las acciones que se realizan cuando se hace clic en el botón command.
De manera predeterminada, se realiza la validación de la página cuando se hace clic en un control Button. La validación de la página determina si los controles de entrada asociados a un control de validación en la página cumplen las reglas de validación especificadas por el control de validación. Si hay un control Button que necesita deshabilitar este comportamiento, como un botón reset, establezca la propiedad CausesValidation en false.
Nota Dado que el elemento <asp:Button> no tiene contenido, se puede cerrar la etiqueta con /> en lugar de una etiqueta de cierre independiente.
Para especificar el título mostrado en el control Button, establezca la propiedad Text.
Para obtener más información sobre los eventos y propiedades del control Button, vea la documentación referente a Button (Clase).
Ejemplo
En el ejemplo siguiente se muestra cómo declarar un control de botón submit en un archivo .aspx.
<asp:Button id="SubmitButton"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
En el ejemplo siguiente se muestra cómo declarar un control de botón command en un archivo .aspx.
<asp:Button id="SortAscendingButton"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
En el siguiente ejemplo se muestra un método de control de eventos que obtiene el clic en el botón y muestra la información que se pasa del botón a sus propiedades CommandName y CommandArgument.
Sub CommandBtn_Click(sender As Object, e As CommandEventArgs)
Message.Text = "You clicked the " & e.CommandName & _
" - " & e.CommandArgument & " button."
End Sub
[C#]
void CommandBtn_Click(Object sender, CommandEventArgs e)
{
Message.Text = "You clicked the " + e.CommandName +
" - " + e.CommandArgument + " button.";
}