TextBox.AutoPostBack Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob ein automatisches Postback an den Server erfolgt, wenn das TextBox-Steuerelement den Fokus verliert, oder legt diesen fest.
public:
virtual property bool AutoPostBack { bool get(); void set(bool value); };public virtual bool AutoPostBack { get; set; }[System.Web.UI.Themeable(false)]
public virtual bool AutoPostBack { get; set; }member this.AutoPostBack : bool with get, set[<System.Web.UI.Themeable(false)>]
member this.AutoPostBack : bool with get, setPublic Overridable Property AutoPostBack As BooleanEigenschaftswert
true, wenn ein automatisches Postback auftritt, wenn das TextBox-Steuerelement den Fokus verliert, andernfalls false. Der Standardwert ist false.
- Attribute
Beispiele
Im folgenden Beispiel wird gezeigt, wie Die AutoPostBack Eigenschaft verwendet wird, um automatisch die Summe der werte anzuzeigen, die in den Textfeldern eingegeben werden, wenn das TextBox Steuerelement den Fokus verliert.
Wichtig
Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.
<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> TextBox Example </title>
<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 id="form1" 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="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> TextBox Example </title>
<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 id="form1" 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>
Hinweise
Verwenden Sie die AutoPostBack Eigenschaft, um anzugeben, ob ein automatisches Postback auf dem Server auftritt, wenn das TextBox Steuerelement den Fokus verliert. Drücken Sie die EINGABETASTE oder die TAB-TASTE, während das TextBox Steuerelement am häufigsten den Fokus ändern kann.
Hinweis
Wenn der übergeordnete Container des Steuerelements eine Schaltfläche enthält, die als Standardschaltfläche gekennzeichnet ist (z. B. wenn der TextBox Container DefaultButton oder DefaultButton die Eigenschaft festgelegt ist), wird das Ereignis der Standardschaltfläche Click als Reaktion auf das automatische Postback nicht ausgelöst.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.