Декларативный синтаксис серверного веб-элемента управления ListBox
Обновлен: Ноябрь 2007
Создает простой список или список множественного выбора.
<asp:ListBox
AccessKey="string"
AppendDataBoundItems="True|False"
AutoPostBack="True|False"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnTextChanged="TextChanged event handler"
OnUnload="Unload event handler"
Rows="integer"
runat="server"
SelectedIndex="integer"
SelectedValue="string"
SelectionMode="Single|Multiple"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:ListBox>
Заметки
Элемент управления ListBox используется для создания элемента управления списком, позволяющего выбрать один или несколько элементов. Свойство Rows используется для задания высоты элемента управления. Чтобы разрешить выбор нескольких элементов, необходимо установить значение свойства SelectionMode равным Multiple.
Для задания пунктов, которые должны отображаться в элементе управления ListBox, разместите по одному элементу ListItem для каждой записи между открывающим и закрывающим тегами элемента управления ListBox.
Элемент управления ListBox также поддерживает привязку данных. Чтобы осуществить привязку элемента управления к источнику данных, сначала необходимо создать источник данных, например, один из объектов DataSourceControl, в котором содержатся элементы, отображаемые в элементе управления. Затем с помощью метода DataBind, источник данных связывается с элементом управления ListBox. Свойства DataTextField и DataValueField используются для указания поля в источнике данных, которое требуется привязать соответственно к свойствам Text и Value каждого элемента списка в элементе управления. Теперь элемент управления ListBox будет отображать сведения из источника данных.
Если свойство SelectionMode установлено равным Multiple, то для того, чтобы определить, какие пункты выбраны в элементе управления ListBox, необходимо выполнить итерацию всех элементов коллекции Items и проверить свойство Selected каждого элемента в коллекции. Если свойство SelectionMode установлено равным Single, для определения индекса выбранного элемента можно использовать свойство SelectedIndex. По этому индексу можно будет извлечь данный элемент из коллекции Items.
Подробные сведения о свойствах и событиях элемента управления ListBox веб-сервера см. в документации класса ListBox.
Пример
В следующем примере показано, как с помощью элемента управления ListBox предложить пользователю список из нескольких заранее заданных вариантов. Выбранный пользователем элемент отображается в элементе управления Label.
<%@ 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>ListBox Example</title>
<script language="VB" runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
If ListBox1.SelectedIndex > - 1 Then
Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
End If
End Sub 'SubmitBtn_Click
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
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>
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<asp:Label id="Label1"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"/>
</form>
</body>
</html>
<%@ 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>ListBox Example</title>
<script language="C#" runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
if (ListBox1.SelectedIndex > -1)
Label1.Text="You chose: " + ListBox1.SelectedItem.Text;
}
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
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>
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<asp:Label id="Label1"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"/>
</form>
</body>
</html>