TextBox.AutoPostBack Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si se produce un postback automático al servidor cuando el control TextBox pierde el foco.
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 BooleanValor de propiedad
true si se produce un postback automático al servidor cuando el control TextBox pierde el foco; de lo contrario, false. De manera predeterminada, es false.
- Atributos
Ejemplos
En el ejemplo siguiente se muestra cómo usar la AutoPostBack propiedad para mostrar automáticamente la suma de los valores especificados en los cuadros de texto cuando el control pierde el TextBox foco.
Importante
Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.
<%@ 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>
Comentarios
Utilice la AutoPostBack propiedad para especificar si se producirá un postback automático en el servidor cuando el control pierda el TextBox foco. Presionar la tecla ENTRAR o la tecla TAB mientras está en el TextBox control es la manera más común de cambiar el foco.
Nota
Si el TextBox contenedor primario del control contiene un botón marcado como el botón predeterminado (por ejemplo, si se establece la propiedad o DefaultButton el contenedorDefaultButton), el evento del Click botón predeterminado no se genera en respuesta al postback automático.
Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.