Sintaxis declarativa del control de servidor Web Button
Actualización: noviembre 2007
Muestra un control de botón de comando en la página de formularios Web Forms.
<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"
/>
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 botón: 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 (que especifica la propiedad CommandName) asociado 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 llevan a cabo cuando se hace clic en el botón submit.
Un botón command tiene asociado un nombre de comando (por ejemplo, Sort) si está establecido el valor de 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 controlador de eventos correspondiente al evento Command. Asimismo, se puede usar la propiedad CommandArgument con un botón command para proporcionar información adicional sobre el comando que se va a llevar a cabo, como por ejemplo Ascending. Se puede proporcionar un controlador de eventos para el evento Command con el fin de controlar mediante programación las acciones que se llevan a cabo cuando se hace clic en el botón command.
Los botones Command se usan con frecuencia en los controles con plantilla con el fin de comunicar una acción al control primario, por ejemplo, la selección en una lista de datos DataList o el cambio de modo en una vista FormView.
De manera predeterminada, la página se valida 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 tiene que deshabilitar este comportamiento, como un botón reset, establezca el valor de la propiedad CausesValidation en false.
Nota
Dado que el elemento <asp:Button> no tiene contenido, se puede cerrar la etiqueta con /> en lugar de utilizar una etiqueta de cierre independiente.
Para especificar el título que se va a mostrar en el control Button, establezca el valor de la propiedad Text.
Para obtener información detallada sobre las propiedades y los eventos del control Button, consulte la documentación relativa a Button.
Ejemplo
En el siguiente ejemplo se muestra la declaración de un control de botón submit en un archivo .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"/>
En el siguiente ejemplo se muestra la declaración de 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"/>
<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 del botón y muestra la información que se pasa del botón a sus propiedades CommandName y 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.";
}