TextBox.AutoPostBack-Eigenschaft
Ruft einen Wert ab, der angibt, ob ein automatisches Postback an den Server erfolgt, wenn ein Benutzer die ENTER- oder die TAB-TASTE drückt, während er sich im TextBox-Steuerelement befindet, oder legt diesen Wert fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property AutoPostBack As Boolean
'Usage
Dim instance As TextBox
Dim value As Boolean
value = instance.AutoPostBack
instance.AutoPostBack = value
[ThemeableAttribute(false)]
public virtual bool AutoPostBack { get; set; }
[ThemeableAttribute(false)]
public:
virtual property bool AutoPostBack {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_AutoPostBack ()
/** @property */
public void set_AutoPostBack (boolean value)
public function get AutoPostBack () : boolean
public function set AutoPostBack (value : boolean)
Eigenschaftenwert
true, wenn ein automatisches Postback an den Server erfolgt, sobald der Benutzer die ENTER- oder die TAB-Taste drückt, während er sich im TextBox-Steuerelement befindet, andernfalls false. Der Standardwert ist false.
Hinweise
Verwenden Sie die AutoPostBack-Eigenschaft, um anzugeben, ob ein automatisches Postback an den Server erfolgt, wenn der Benutzer die ENTER- oder die TAB-TASTE drückt, während er sich im TextBox-Steuerelement befindet.
Hinweis
Ein Postback erfolgt nur, wenn der Benutzer die ENTER- oder die TAB-TASTE drückt, während er sich im TextBox-Steuerelement befindet.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.
| Thema | Position |
|---|---|
| Gewusst wie: Reagieren auf Änderungen in einem TextBox-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen des Sendeverhaltens von ASP.NET-Webserversteuerelementen zum Server | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Reagieren auf Änderungen in einem TextBox-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen des Sendeverhaltens von ASP.NET-Webserversteuerelementen zum Server | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Reagieren auf Änderungen in einem TextBox-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Festlegen des Sendeverhaltens von ASP.NET-Webserversteuerelementen zum Server | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der AutoPostBack-Eigenschaft die Summe der in die Textfelder eingegebenen Werte automatisch angezeigt wird, wenn der Benutzer die ENTER- oder die TAB-TASTE drückt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Protected Sub Page_Load(sender As Object, e As EventArgs)
Dim Answer As Integer
' Due to a timing issue with when page validation occurs, call the
' Validate method to ensure that the values on the page are valid.
Page.Validate()
' Add the values in the text boxes if the page is valid.
If Page.IsValid Then
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)
AnswerMessage.Text = Answer.ToString()
End If
End Sub
</script>
</head>
<body>
<form runat="server">
<h3> TextBox Example </h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes. <br>
The two values are automatically added <br>
when you tab out of the text boxes. <br>
</td>
</tr>
<tr>
<td colspan="5">
</td>
</tr>
<tr align="center">
<td>
<asp:TextBox ID="Value1"
Columns="2"
MaxLength="3"
AutoPostBack="True"
Text="1"
runat="server"/>
</td>
<td>
+
</td>
<td>
<asp:TextBox ID="Value2"
Columns="2"
MaxLength="3"
AutoPostBack="True"
Text="1"
runat="server"/>
</td>
<td>
=
</td>
<td>
<asp:Label ID="AnswerMessage"
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
<asp:RangeValidator
ID="Value1RangeValidator"
ControlToValidate="Value1"
Type="Integer"
MinimumValue="1"
MaximumValue="100"
ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
</td>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value2RequiredValidator"
ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
<asp:RangeValidator
ID="Value2RangeValidator"
ControlToValidate="Value2"
Type="Integer"
MinimumValue="1"
MaximumValue="100"
ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
</td>
<td>
 
</td
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
protected void Page_Load(Object sender, EventArgs e)
{
int Answer;
// Due to a timing issue with when page validation occurs, call the
// Validate method to ensure that the values on the page are valid.
Page.Validate();
// Add the values in the text boxes if the page is valid.
if(Page.IsValid)
{
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);
AnswerMessage.Text = Answer.ToString();
}
}
</script>
</head>
<body>
<form runat="server">
<h3> TextBox Example </h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes. <br>
The two values are automatically added <br>
when you tab out of the text boxes. <br>
</td>
</tr>
<tr>
<td colspan="5">
</td>
</tr>
<tr align="center">
<td>
<asp:TextBox ID="Value1"
Columns="2"
MaxLength="3"
AutoPostBack="True"
Text="1"
runat="server"/>
</td>
<td>
+
</td>
<td>
<asp:TextBox ID="Value2"
Columns="2"
MaxLength="3"
AutoPostBack="True"
Text="1"
runat="server"/>
</td>
<td>
=
</td>
<td>
<asp:Label ID="AnswerMessage"
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
<asp:RangeValidator
ID="Value1RangeValidator"
ControlToValidate="Value1"
Type="Integer"
MinimumValue="1"
MaximumValue="100"
ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
</td>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value2RequiredValidator"
ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
<asp:RangeValidator
ID="Value2RangeValidator"
ControlToValidate="Value2"
Type="Integer"
MinimumValue="1"
MaximumValue="100"
ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
EnableClientScript="False"
Display="Dynamic"
runat="server"/>
</td>
<td>
 
</td
</tr>
</table>
</form>
</body>
</html>
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
TextBox-Klasse
TextBox-Member
System.Web.UI.WebControls-Namespace
TextChanged
OnTextChanged