Sintaxis declarativa del control de servidor HtmlInputButton
Actualización: noviembre 2007
Crea un control de servidor que se asigna a los elementos HTML <input type=button>, <input type=submit> y <input type=reset>, y permite crear un botón de comando, un botón Enviar o un botón Restablecer, respectivamente.
<input
Type="Button|Reset|Submit"
EnableViewState="False|True"
Id="string"
Visible="False|True"
OnDataBinding="OnDataBinding event handler"
OnDisposed="OnDisposed event handler"
OnInit="OnInit event handler"
OnLoad="OnLoad event handler"
OnPreRender="OnPreRender event handler"
OnServerClick="OnServerClick event handler"
OnUnload="OnUnload event handler"
runat="server"
/>
Comentarios
Utilice el control HtmlInputButton para programar con los elementos HTML <input type=button>, <input type=submit> y <input type=reset>. Cuando el usuario hace clic en un control HtmlInputButton, la entrada del formulario en el que está incrustado el control se envía al servidor para su proceso. A continuación, se devuelve la respuesta al explorador que la ha solicitado.
Si se proporciona un controlador de eventos personalizado para el evento ServerClick, se puede llevar a cabo un conjunto de instrucciones específicas cuando se hace clic en el control.
Nota
Un botón reset no admite el evento ServerClick. Cuando se hace clic en un botón reset, no tienen por qué borrarse necesariamente todos los controles de entrada de la página. En vez de esto, los botones vuelven al estado original que tenían cuando se cargó la página. Por ejemplo, si un cuadro de texto contenía en un principio el valor "JohnDoe", al hacerse clic en el botón reset, el cuadro de texto volverá a tener ese valor.
Cuando se utiliza junto con los controles HtmlInputText y HtmlTextArea, se pueden crear páginas de autenticación o de datos proporcionados por el usuario que se pueden procesar en el servidor.
Nota
Este control no requiere una etiqueta de cierre.
Ejemplo
En el ejemplo siguiente se muestra cómo usar un control HtmlInputButton para enviar un formulario al servidor para su procesamiento.
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub AddButton_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim Answer As Integer
Answer = Convert.ToInt32(Value1.Value) + Convert.ToInt32(Value2.Value)
AnswerMessage.InnerHtml = Answer.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlInputButton Example </title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<h3> HtmlInputButton Example</h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes. <br />
Click the Add button to add the two values. <br />
Click the Reset button to reset the text boxes.
</td>
</tr>
<tr>
<td colspan="5">
</td>
</tr>
<tr align="center">
<td>
<input id="Value1"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server" />
</td>
<td>
+
</td>
<td>
<input id="Value2"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server" />
</td>
<td>
=
</td>
<td>
<span id="AnswerMessage"
runat="server" />
</td>
</tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Value1"
ErrorMessage="Please enter an value.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value1MinCompareValidator"
ControlToValidate="Value1"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value1MaxCompareValidator"
ControlToValidate="Value1"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server" />
</td>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value2RequiredValidator"
ControlToValidate="Value2"
ErrorMessage="Please enter an value.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value2MinCompareValidator"
ControlToValidate="Value2"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value2MaxCompareValidator"
ControlToValidate="Value2"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server" />
</td>
<td>
</td>
</tr>
<tr align="center">
<td colspan="4">
<input id="Submit1" type="Submit"
name="AddButton"
value="Add"
onserverclick="AddButton_Click"
runat="server" />
<input id="Reset1" type="Reset"
name="AddButton"
value="Reset"
runat="server"/>
</td>
<td>
</td>
</tr>
</table>
</div>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void AddButton_Click(Object sender, EventArgs e)
{
int Answer;
Answer = Convert.ToInt32(Value1.Value) +
Convert.ToInt32(Value2.Value);
AnswerMessage.InnerHtml = Answer.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlInputButton Example </title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<h3> HtmlInputButton Example</h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes. <br />
Click the Add button to add the two values. <br />
Click the Reset button to reset the text boxes.
</td>
</tr>
<tr>
<td colspan="5">
</td>
</tr>
<tr align="center">
<td>
<input id="Value1"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server" />
</td>
<td>
+
</td>
<td>
<input id="Value2"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server" />
</td>
<td>
=
</td>
<td>
<span id="AnswerMessage"
runat="server" />
</td>
</tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Value1"
ErrorMessage="Please enter an value.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value1MinCompareValidator"
ControlToValidate="Value1"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value1MaxCompareValidator"
ControlToValidate="Value1"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server" />
</td>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value2RequiredValidator"
ControlToValidate="Value2"
ErrorMessage="Please enter an value.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value2MinCompareValidator"
ControlToValidate="Value2"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server" />
<asp:CompareValidator
ID="Value2MaxCompareValidator"
ControlToValidate="Value2"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server" />
</td>
<td>
</td>
</tr>
<tr align="center">
<td colspan="4">
<input id="Submit1" type="Submit"
name="AddButton"
value="Add"
onserverclick="AddButton_Click"
runat="server" />
<input id="Reset1" type="Reset"
name="AddButton"
value="Reset"
runat="server"/>
</td>
<td>
</td>
</tr>
</table>
</div>
</form>
</body>
</html>
Vea también
Tareas
Cómo: Agregar controles de servidor HTML a una página Web mediante la sintaxis de ASP.NET