HtmlSelect.Multiple 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 múltiplos itens podem ser selecionados simultaneamente no HtmlSelect controlo.
public:
property bool Multiple { bool get(); void set(bool value); };public bool Multiple { get; set; }member this.Multiple : bool with get, setPublic Property Multiple As BooleanValor de Propriedade
true se vários itens puderem ser selecionados simultaneamente no HtmlSelect controlo; caso contrário, false. O valor predefinido é false.
Exemplos
O exemplo de código seguinte demonstra como usar a Multiple propriedade para especificar se múltiplos itens podem ser selecionados no HtmlSelect controlo.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button_Click (Object sender, EventArgs e)
{
Label1.Text = "You selected:";
for (int i=0; i<=Select1.Items.Count - 1; i++)
{
if (Select1.Items[i].Selected)
Label1.Text += "<br /> -" + Select1.Items[i].Text;
}
Select1.Size = Convert.ToInt32(Select2.Value);
}
void Check_Changed (Object sender, EventArgs e)
{
Select1.Multiple = CheckBox1.Checked;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3> HtmlSelect Example </h3>
Select item(s) from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1" selected="selected"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<hr />
HtmlSelect Size: <br />
<select id="Select2"
runat="server">
<option value="1"> 1 </option>
<option value="2"> 2 </option>
<option value="3"> 3 </option>
<option value="4" selected="selected"> 4 </option>
<option value="5"> 5 </option>
<option value="6"> 6 </option>
</select>
<asp:CheckBox id="CheckBox1"
Text="Enable Multiple Property"
AutoPostBack="True"
OnCheckedChanged="Check_Changed"
Checked="True"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1" runat="server"/>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click (sender As Object, e As EventArgs)
Dim i As Integer
Label1.Text = "You selected:"
For i = 0 to Select1.Items.Count - 1
If Select1.Items(i).Selected Then
Label1.Text = Label1.Text & "<br /> -" & Select1.Items(i).Text
End If
Next
Select1.Size = CInt(Select2.Value)
End Sub
Sub Check_Changed (sender As Object, e As EventArgs)
Select1.Multiple = CheckBox1.Checked
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3> HtmlSelect Example </h3>
Select item(s) from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4" selected="selected"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<hr />
HtmlSelect Size: <br />
<select id="Select2"
runat="server">
<option value="1" selected="selected"> 1 </option>
<option value="2"> 2 </option>
<option value="3"> 3 </option>
<option value="4"> 4 </option>
<option value="5"> 5 </option>
<option value="6"> 6 </option>
</select>
<asp:CheckBox id="CheckBox1"
Text="Enable Multiple Property"
AutoPostBack="True"
OnCheckedChanged="Check_Changed"
Checked="True"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1" runat="server"/>
</div>
</form>
</body>
</html>
Observações
Use a Multiple propriedade para especificar se múltiplos itens podem ser selecionados simultaneamente HtmlSelect no controlo.
Por defeito, o HtmlSelect controlo é apresentado como uma caixa de lista suspensa. Se permitir múltiplas seleções (definindo a Multiple propriedade para true) ou especificar uma altura superior a uma linha (definindo a Size propriedade para um valor superior a 1), o controlo é apresentado como uma caixa de lista.
Para determinar os itens selecionados num HtmlSelect controlo que permita múltiplas seleções simultâneas, itere pela Items coleção e teste a ListItem.Selected propriedade de cada item.
Note
O multiple atributo é renderizado no HtmlSelect controlo apenas se esta propriedade estiver definida como true.