HtmlInputText-Klasse
Ermöglicht den programmgesteuerten Zugriff auf das <input type= text>-HTML-Element und das <input type= password>-HTML-Element auf dem Server.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ValidationPropertyAttribute("Value")> _
Public Class HtmlInputText
Inherits HtmlInputControl
Implements IPostBackDataHandler
'Usage
Dim instance As HtmlInputText
[ValidationPropertyAttribute("Value")]
public class HtmlInputText : HtmlInputControl, IPostBackDataHandler
[ValidationPropertyAttribute(L"Value")]
public ref class HtmlInputText : public HtmlInputControl, IPostBackDataHandler
/** @attribute ValidationPropertyAttribute("Value") */
public class HtmlInputText extends HtmlInputControl implements IPostBackDataHandler
ValidationPropertyAttribute("Value")
public class HtmlInputText extends HtmlInputControl implements IPostBackDataHandler
Hinweise
Mit dem HtmlInputText-Steuerelement können Sie ein einzeiliges Textfeld erstellen, in dem der Benutzer Text oder ein Kennwort eingeben kann. Die MaxLength-Eigenschaft gibt an, wie viele Zeichen maximal in das Textfeld eingegeben werden können. Mithilfe der Size-Eigenschaft können Sie die Breite des Textfelds angeben. Mit der Value-Eigenschaft können Sie den Wert bestimmen, den der Benutzer in das Textfeld eingegeben hat. Das HtmlInputText-Steuerelement stellt ein ServerChange-Ereignis bereit, das ausgelöst wird, wenn der Wert der Value-Eigenschaft zwischen Bereitstellungen auf dem Server geändert wird. Daher können Sie einen Ereignishandler erstellen, der immer dann einen benutzerdefinierten Satz von Anweisungen ausführt, wenn das Ereignis ausgelöst wird.
Hinweis
Das HtmlInputText-Steuerelement besitzt keine eingebaute Methode, um Daten an den Server zurückzusenden. Um den Wert des Steuerelements zurück an den Server zu senden, müssen Sie auf der Webseite ein anderes Steuerelement bereitstellen, das Übermittlungen an den Server unterstützt, z. B. ein HtmlButton-Steuerelement.
Ein mehrzeiliges Textfeld können Sie mithilfe des HtmlTextArea-Steuerelements erstellen.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlInputText finden Sie unter HtmlInputText-Konstruktor.
| Thema | Position |
|---|---|
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit dem HtmlInputText-Steuerelement Benutzereingaben abgerufen werden.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Protected Sub AddButton_Click(sender As Object, e As EventArgs)
Dim Answer As Integer
Answer = Convert.ToInt32(Value1.Value) + Convert.ToInt32(Value2.Value)
AnswerMessage.InnerHtml = Answer.ToString()
End Sub
</script>
</head>
<body>
<form runat="server">
<h3> HtmlInputText 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 a 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 a 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 Type="Submit"
Name="AddButton"
Value="Add"
OnServerClick="AddButton_Click"
runat="server"/>
<input Type="Reset"
Name="AddButton"
Value="Reset"
runat="server"/>
</td>
<td>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<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>
</head>
<body>
<form runat="server">
<h3> HtmlInputText 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 a 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 a 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 Type="Submit"
Name="AddButton"
Value="Add"
OnServerClick="AddButton_Click"
runat="server"/>
<input Type="Reset"
Name="AddButton"
Value="Reset"
runat="server"/>
</td>
<td>
</td>
</tr>
</table>
</form>
</body>
</html>
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlInputControl
System.Web.UI.HtmlControls.HtmlInputText
System.Web.UI.HtmlControls.HtmlInputPassword
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlInputText-Member
System.Web.UI.HtmlControls-Namespace
HtmlTextArea
HtmlInputPassword-Klasse