ListControl.AutoPostBack Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se um postback para o servidor ocorre automaticamente quando o usuário altera a seleção de lista.
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, set
Public Overridable Property AutoPostBack As Boolean
Valor da propriedade
true
se um postback para o servidor ocorrer automaticamente sempre que o usuário alterar a seleção da lista; caso contrário, false
. O padrão é false
.
- Atributos
Exemplos
O exemplo a seguir demonstra como habilitar AutoPostBack para o ListBox controle .
<%@ 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 runat="server">
<title>ListBox AutoPostBack Example</title>
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
if (ListBox1.SelectedItem != null)
Label1.Text = "You selected: " + ListBox1.SelectedItem.Value;
else
Label1.Text = "";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ListBox AutoPostBack Example</h3>
Select an item from the list box: <br /><br />
<asp:ListBox id="ListBox1"
Rows="4"
AutoPostBack="True"
SelectionMode="Single"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</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 runat="server">
<title>ListBox AutoPostBack Example</title>
<script runat="server">
Sub Page_Load(sender As Object, e As EventArgs)
If Not IsNothing(ListBox1.SelectedItem)
Label1.Text = "You selected: " & ListBox1.SelectedItem.Value
Else
Label1.Text = ""
End If
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ListBox AutoPostBack Example</h3>
Select an item from the list box: <br /><br />
<asp:ListBox id="ListBox1"
Rows="4"
AutoPostBack="True"
SelectionMode="Single"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
Comentários
Defina essa propriedade true
como se o servidor precisar capturar a seleção assim que ela for feita. Por exemplo, outros controles na página da Web podem ser preenchidos automaticamente dependendo da seleção do usuário de um controle de lista.
Essa propriedade pode ser usada para permitir a população automática de outros controles na página da Web com base na seleção de um usuário de uma lista.
O valor dessa propriedade é armazenado no estado de exibição.
Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Capas.