Общие сведения о серверном веб-элементе управления ListBox
Обновлен: Ноябрь 2007
Серверный веб-элемент управления ListBox дает возможность выбирать один или несколько элементов из списка предопределенных элементов.
В этом разделе рассматриваются следующие темы:
Сценарии
Функциональные возможности
Базовые сведения
Примеры кода.
Ссылки на классы
Сценарии
С помощью серверного веб-элемента управления ListBox можно одновременно отображать несколько элементов, а также выбирать один или несколько элементов из списка предопределенных элементов. Элемент управления ListBox отличается от элемента управления DropDownList тем, что позволяет одновременно отображать, а также выбирать несколько элементов.
К началу
Функциональные возможности
Элемент управления ListBox позволяет выполнять следующие действия.
Настраивать элемент управления для отображения определенного количества элементов.
Задавать размер элемента управления (в точках).
Указывать список отображаемых элементов с помощью привязки данных.
Определять, какой элемент или элементы выбраны.
Указывать выбранный элемент или элементы программным путем.
К началу
Основные сведения
Элемент управления ListBox обычно используется для отображения сразу нескольких элементов. Вид представления списка можно задать одним из следующим способов:
Количество отображаемых строк. С помощью элемента управления можно задать определенное количество элементов для отображения. Если элемент управления содержит больше элементов, чем указано, появляется вертикальная полоса прокрутки.
Высота и ширина. Можно задать размер элемента управления в точках. В этом случае вне зависимости от заданного количества строк отображается то количество элементов, которое помещается по высоте в элементе управления. Некоторые обозреватели не поддерживают указание высоты и ширины в точках и используют указание количества строк.
Как и в других серверных веб-элементах управления, можно использовать объекты стилей для определения вида элемента управления. Подробные сведения см. в разделе Серверные веб-элементы управления ASP.NET и стили CSS.
Элементы списка
Элемент управления ListBox содержит один или несколько элементов списка, каждый из которых представляет собой объект типа ListItem со своими собственными свойствами. Эти свойства описаны в приведенной ниже таблице.
Свойство |
Описание |
|---|---|
Задает текст, который отображается в списке. |
|
Содержит значение, связанное с элементом. С помощью этого свойства можно связать некоторое значение с определенным элементом, не отображая его. Например, можно связать свойство Text с названием цвета, а свойство Value — с его шестнадцатеричным представлением. |
|
Указывает, выбран ли элемент в настоящий момент. |
Программная работа с элементами осуществляется с помощью коллекции Items элемента управления ListBox. Items является обычной коллекцией, в которую можно добавлять элементы, удалять их, а также очищать коллекцию и т. д.
Выбранный в данный момент элемент доступен в свойстве SelectedItem элемента управления ListBox. Если элемент управления находится в режиме выбора одного элемента, это свойство возвращает один выбранный элемент. Если элемент управления находится в режиме выбора нескольких элементов, выбранные элементы возвращаются в результате выполнения цикла по коллекции Items и изучения свойства Selected каждого элемента.
Единичное и множественное выделение
Отдельный элемент можно выделить левой кнопкой мыши. Если задать для элемента управления ListBox режим выбора нескольких элементов, пользователи смогут указать несколько элементов, удерживая клавиши CTRL или SHIFT и щелкая левой кнопкой мыши.
Привязка данных к элементу управления
Серверный веб-элемент управления ListBox можно использовать для перечисления параметров, доступных странице благодаря использованию элемента управления источником данных. Каждый элемент в элементе управления ListBox соответствует элементу в источнике данных, которым, как правило, является запись.
Элемент управления отображает одно поле из источника. Дополнительно можно связать элемент управления со вторым полем и задать для элемента значение, которое не отображается.
Как и в других серверных элементах управления можно привязать любое свойство (например, цвет или размер) элемента управления к данным. Дополнительные сведения см. в разделе Практическое руководство. Заполнение списочных серверных веб-элементов управления данными из источника данных.
События ListBox
Элемент управления ListBox вызывает событие SelectedIndexChanged при выборе элемента пользователем. По умолчанию это событие не приводит к отправке страницы на сервер, однако можно заставить элемент управления выполнить немедленный обратный запрос, задав свойству AutoPostBack значение true.
.gif "Примечание") Примечание. |
|---|
Для автоматического выполнения обратной передачи необходимо, чтобы веб-обозреватель поддерживал ECMAScript (JScript или JavaScript), а также чтобы данные сценарии были разрешены в обозревателе пользователя. |
Примеры кода
Практическое руководство. Добавление элементов в серверные веб-элементы управления со списком
Практическое руководство. Выбор элементов в серверных веб-элементах управления "Список"
Практическое руководство. Отклик на изменения в списочных серверных веб-элементах управления
К началу
Ссылки на классы
В следующей таблице перечислены классы, связанные с элементом управления ListBox.
Член |
Описание |
|---|---|
Основной класс для элемента управления. |
|
Класс, представляющий каждый элемент в списке. |
К началу
См. также
Ссылки
Общие сведения о серверном веб-элементе управления DropDownList