HtmlInputButton Server Control Declarative Syntax
Creates a server-side control that maps to the <input type=button>, <input type=submit>, and <input type=reset> HTML elements and allows you to create a command button, submit button, or reset button, respectively.
<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"
/>
Remarks
Use the HtmlInputButton control to program against the <input type=button>, <input type=submit>, and <input type=reset> HTML elements. When a user clicks an HtmlInputButton control, input from the form that the control is embedded on is posted to the server and processed. A response is then sent back to the requesting browser.
By providing a custom event handler for the ServerClick event, you can perform a specific set of instructions when the control is clicked.
.gif) Note |
|---|
A reset button does not support the ServerClick event. When a reset button is clicked, all input controls on the page are not necessarily cleared. Instead, they are returned to their original state when the page was loaded. For example, if a text box originally contained the value "JohnDoe", clicking on the reset button would return the text box to this value. |
When used in conjunction with the HtmlInputText and HtmlTextArea controls, you can create user input or authentication pages that can be processed on the server.
| Note |
|---|
This control does not require a closing tag. |
Example
The following example demonstrates how to use an HtmlInputButton control to submit a form to the server for processing.
<%@ 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>
See Also
Tasks
How to: Add HTML Server Controls to a Web Page Using ASP.NET Syntax