ListBox.SelectionMode 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.
Obtém ou define o modo de seleção do ListBox controlo.
public:
virtual property System::Web::UI::WebControls::ListSelectionMode SelectionMode { System::Web::UI::WebControls::ListSelectionMode get(); void set(System::Web::UI::WebControls::ListSelectionMode value); };public virtual System.Web.UI.WebControls.ListSelectionMode SelectionMode { get; set; }member this.SelectionMode : System.Web.UI.WebControls.ListSelectionMode with get, setPublic Overridable Property SelectionMode As ListSelectionModeValor de Propriedade
Um dos ListSelectionMode valores. O valor predefinido é Single.
Exceções
O modo de seleção especificado não é um dos valores ListSelectionMode .
Exemplos
O exemplo seguinte ilustra como usar a SelectionMode propriedade para permitir ao utilizador selecionar múltiplas seleções do ListBox controlo.
<%@ 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 Example</title>
<script runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Message.Text = "You chose: <br />";
// Iterate through the Items collection of the ListBox and
// display the selected items.
foreach (ListItem item in ListBox1.Items)
{
if(item.Selected)
{
Message.Text += item.Text + "<br />";
}
}
}
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
Select items from the list and click Submit. <br />
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Multiple"
runat="server">
<asp:ListItem Selected="True">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:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<br /><br />
<asp:Label id="Message"
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 Example</title>
<script runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Message.Text = "You chose: <br />"
' Iterate through the Items collection of the ListBox and
' display the selected items.
Dim item As ListItem
For Each item in ListBox1.Items
If item.Selected Then
Message.Text &= item.Text & "<br />"
End If
Next
End Sub
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
Select items from the list and click Submit. <br />
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Multiple"
runat="server">
<asp:ListItem Selected="True">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:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<br /><br />
<asp:Label id="Message"
runat="server"/>
</form>
</body>
</html>
Observações
Use a SelectionMode propriedade para especificar o comportamento de modo do ListBox controlo. Definir esta propriedade indica ListSelectionMode.Single que apenas um único item pode ser selecionado no ListBox controlo, enquanto ListSelectionMode.Multiple especifica que múltiplos itens podem ser selecionados.
O valor da SelectionMode propriedade é armazenado no estado de visualização.