Общие сведения о серверном веб-элементе управления ListBox

Visual Studio 2010

Обновлен: Ноябрь 2007

Серверный веб-элемент управления ListBox дает возможность выбирать один или несколько элементов из списка предопределенных элементов.

В этом разделе рассматриваются следующие темы:

С помощью серверного веб-элемента управления ListBox можно одновременно отображать несколько элементов, а также выбирать один или несколько элементов из списка предопределенных элементов. Элемент управления ListBox отличается от элемента управления DropDownList тем, что позволяет одновременно отображать, а также выбирать несколько элементов.

К началу

Элемент управления ListBox позволяет выполнять следующие действия.

  • Настраивать элемент управления для отображения определенного количества элементов.

  • Задавать размер элемента управления (в точках).

  • Указывать список отображаемых элементов с помощью привязки данных.

  • Определять, какой элемент или элементы выбраны.

  • Указывать выбранный элемент или элементы программным путем.

К началу

Элемент управления ListBox обычно используется для отображения сразу нескольких элементов. Вид представления списка можно задать одним из следующим способов:

  • Количество отображаемых строк. С помощью элемента управления можно задать определенное количество элементов для отображения. Если элемент управления содержит больше элементов, чем указано, появляется вертикальная полоса прокрутки.

  • Высота и ширина. Можно задать размер элемента управления в точках. В этом случае вне зависимости от заданного количества строк отображается то количество элементов, которое помещается по высоте в элементе управления. Некоторые обозреватели не поддерживают указание высоты и ширины в точках и используют указание количества строк.

Как и в других серверных веб-элементах управления, можно использовать объекты стилей для определения вида элемента управления. Подробные сведения см. в разделе Серверные веб-элементы управления ASP.NET и стили CSS.

Элементы списка

Элемент управления ListBox содержит один или несколько элементов списка, каждый из которых представляет собой объект типа ListItem со своими собственными свойствами. Эти свойства описаны в приведенной ниже таблице.

Свойство

Описание

Text

Задает текст, который отображается в списке.

Value

Содержит значение, связанное с элементом. С помощью этого свойства можно связать некоторое значение с определенным элементом, не отображая его. Например, можно связать свойство Text с названием цвета, а свойство Value — с его шестнадцатеричным представлением.

Selected

Указывает, выбран ли элемент в настоящий момент.

Программная работа с элементами осуществляется с помощью коллекции Items элемента управления ListBox. Items является обычной коллекцией, в которую можно добавлять элементы, удалять их, а также очищать коллекцию и т. д.

Выбранный в данный момент элемент доступен в свойстве SelectedItem элемента управления ListBox. Если элемент управления находится в режиме выбора одного элемента, это свойство возвращает один выбранный элемент. Если элемент управления находится в режиме выбора нескольких элементов, выбранные элементы возвращаются в результате выполнения цикла по коллекции Items и изучения свойства Selected каждого элемента.

Единичное и множественное выделение

Отдельный элемент можно выделить левой кнопкой мыши. Если задать для элемента управления ListBox режим выбора нескольких элементов, пользователи смогут указать несколько элементов, удерживая клавиши CTRL или SHIFT и щелкая левой кнопкой мыши.

Привязка данных к элементу управления

Серверный веб-элемент управления ListBox можно использовать для перечисления параметров, доступных странице благодаря использованию элемента управления источником данных. Каждый элемент в элементе управления ListBox соответствует элементу в источнике данных, которым, как правило, является запись.

Элемент управления отображает одно поле из источника. Дополнительно можно связать элемент управления со вторым полем и задать для элемента значение, которое не отображается.

Как и в других серверных элементах управления можно привязать любое свойство (например, цвет или размер) элемента управления к данным. Дополнительные сведения см. в разделе Практическое руководство. Заполнение списочных серверных веб-элементов управления данными из источника данных.

События ListBox

Элемент управления ListBox вызывает событие SelectedIndexChanged при выборе элемента пользователем. По умолчанию это событие не приводит к отправке страницы на сервер, однако можно заставить элемент управления выполнить немедленный обратный запрос, задав свойству AutoPostBack значение true.

01aeha49.alert_note(ru-ru,VS.100).gifПримечание.

Для автоматического выполнения обратной передачи необходимо, чтобы веб-обозреватель поддерживал ECMAScript (JScript или JavaScript), а также чтобы данные сценарии были разрешены в обозревателе пользователя.

В следующей таблице перечислены классы, связанные с элементом управления ListBox.

Член

Описание

ListBox

Основной класс для элемента управления.

ListItem

Класс, представляющий каждый элемент в списке.

К началу

Показ: