Deklarative Syntax des HtmlInputButton-Serversteuerelements
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Erstellt ein serverseitiges Steuerelement, das den HTML-Elementen <input type=button>, <input type=submit> und <input type=reset> zugeordnet wird und das Erstellen einer Befehlsschaltfläche, einer Schaltfläche Senden und einer Schaltfläche Zurücksetzen ermöglicht.
<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"
/>
Hinweise
Verwenden Sie das HtmlInputButton-Steuerelement, um die HTML-Elemente <input type=button>, <input type=submit> und <input type=reset> zu programmieren. Wenn der Benutzer auf ein HtmlInputButton-Steuerelement klickt, wird die Eingabe aus dem Formular, in das das Steuerelement eingebettet ist, an den Server gesendet und verarbeitet. Anschließend wird eine Reaktion an den anfordernden Browser zurückgesendet.
Durch Bereitstellen eines benutzerdefinierten Ereignishandlers für das ServerClick-Ereignis können Sie eine bestimmte Folge von Anweisungen ausführen, wenn auf das Steuerelement geklickt wird.
Hinweis
Eine reset-Schaltfläche bietet keine Unterstützung für das ServerClick-Ereignis.Wenn auf eine reset-Schaltfläche geklickt wird, werden nicht notwendigerweise alle Eingabesteuerelemente auf der Seite geleert.Vielmehr werden diese in den ursprünglichen Status zurückversetzt, den sie hatten, als die Seite geladen wurde.Wenn z. B. ein Textfeld ursprünglich den Wert "JohnDoe" enthielt, wird das Textfeld durch Klicken auf die reset-Schaltfläche auf diesen Wert zurückgesetzt.
Bei der Verwendung in Verbindung mit dem HtmlInputText-Steuerelement und dem HtmlTextArea-Steuerelement können Sie Benutzereingabe- oder Authentifizierungsseiten erstellen, die auf dem Server verarbeitet werden können.
Hinweis
Dieses Steuerelement erfordert kein Endtag.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung eines HtmlInputButton-Steuerelements zum Senden eines Formulars zur Verarbeitung auf dem Server.
<%@ 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>
Siehe auch
Aufgaben
How to: Add HTML Server Controls to a Web Forms Page using ASP.NET Syntax