Share via


Sintaxis declarativa del control de servidor HtmlInputButton

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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">
                 &nbsp;
             </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>
                 &nbsp;
             </td>
         </tr>
         <tr align="center">
             <td colspan="4">
                 <input id="Submit1" type="Submit"
                     name="AddButton"
                     value="Add"
                     onserverclick="AddButton_Click"
                     runat="server" />
                 &nbsp;&nbsp;&nbsp;
                 <input id="Reset1" type="Reset"
                     name="AddButton"
                     value="Reset"
                     runat="server"/>
             </td>
             <td>
                 &nbsp;
            </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">
                 &nbsp;
             </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>
                 &nbsp;
             </td>
         </tr>
         <tr align="center">
             <td colspan="4">
                 <input id="Submit1" type="Submit"
                     name="AddButton"
                     value="Add"
                     onserverclick="AddButton_Click"
                     runat="server" />
                 &nbsp;&nbsp;&nbsp;
                 <input id="Reset1" type="Reset"
                     name="AddButton"
                     value="Reset"
                     runat="server"/>
             </td>
             <td>
                 &nbsp;
            </td>
        </tr>
    </table>


    </div>
</form>
</body>
</html>

Vea también

Tareas

How to: Add HTML Server Controls to a Web Forms Page using ASP.NET Syntax

Referencia

HtmlInputButton