TextBox.AutoPostBack Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se ocorre um postback automático para o servidor quando o TextBox controlo perde o 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 Propriedade
true se ocorrer um postback automático quando o TextBox controlo perde o foco; caso contrário, false. A predefinição é false.
- Atributos
Exemplos
O exemplo seguinte mostra como usar a AutoPostBack propriedade para mostrar automaticamente a soma dos valores inseridos nas caixas de texto quando o TextBox controlo perde o foco.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de 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>
Observações
Use a AutoPostBack propriedade para especificar se ocorrerá um postback automático para o servidor quando o TextBox controlo perder o foco. Pressionar a tecla ENTER ou TAB enquanto está no TextBox controlo é a forma mais comum de mudar o foco.
Note
Se o TextBox contentor pai do controlo contiver um botão marcado como botão padrão (por exemplo, se a propriedade do DefaultButtonDefaultButton contentor ou do utilizador estiver definida), o evento do Click botão padrão não é ativado em resposta ao postback automático.
Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.