Общие сведения о серверных веб-элементах управления CheckBox и CheckBoxList
Обновлен: Ноябрь 2007
Элементы управления CheckBoxList и CheckBox позволяют пользователям указывать варианты да/нет (истина/ложь).
В этом разделе рассматриваются следующие темы:
Функциональные возможности
Базовые сведения
Примеры кода
Справочные сведения по классам
Функциональные возможности
Можно использовать элементы управления CheckBox и CheckBoxList, чтобы:
Генерировать обратную передачу страницы, если флажок установлен.
Перехватывать взаимодействие пользователя, когда он устанавливает флажок.
Привязывать каждый флажок привязан к данным из базы данных.
К началу
Базовые сведения
Для добавления флажков на веб-страницу ASP.NET можно использовать серверные веб-элементы управление двух типов: отдельные элементы управления CheckBox или элемент управления CheckBoxList. Оба элемента управления позволяют пользователям указывать варианты да/нет (истина/ложь).
Элемент управления CheckBox добавляется на страницу, и работа с ним ведется как с отдельным элементом. Можно также использовать элемент управления CheckBoxList. Это отдельный элемент управления, выступающий в качестве родительского элемента для коллекции элементов списка флажков. Он происходит из базового класса ListControl и, следовательно, в большой степени его использование аналогично использованию серверных веб-элементов управления ListBox, DropDownList, RadioButtonList и BulletedList. Многие процедуры для работы с элементом управления CheckBoxList совпадают с процедурами для других серверных веб-элементов управления списком.
Оба типа элементов управления имеют свои преимущества. При использовании отдельных элементов управления CheckBox предоставляется большая свобода при размещении флажков на странице, чем при использовании элемента управления CheckBoxList. Например, между флажками можно отображать текст, не являющийся текстом самого флажка. Кроме того, можно задать свой шрифт и цвет для каждого отдельного флажка.
Элемент управления CheckBoxList предпочтителен при необходимости создания ряда флажков для данных из источника данных. (Можно привязать отдельный элемент управления CheckBox к данным).
.gif "Примечание") Примечание. |
|---|
Можно также использовать элемент управления HtmlInputCheckBox для добавления флажков на веб-страницу ASP.NET. Дополнительные сведения см. в разделе Декларативный синтаксис серверного элемента управления HtmlInputCheckBox. |
События CheckBox и CheckBoxList
События используются по-разному для отдельных элементов управления CheckBox и элемента управления CheckBoxList.
События элемента управления CheckBox
Отдельные элементы управления CheckBox вызывают событие CheckedChanged, когда пользователь щелкает элемент управления. По умолчанию это событие не приводит к немедленной отправке страницы на сервер. Однако можно принудительно задать, чтобы элемент управления немедленно выполнил обратную передачу, указав для свойства AutoPostBack значение true. Дополнительные сведения см. в разделе Практическое руководство. Отклик на выбор пользователя в серверном веб-элементе управления CheckBox.
| Примечание. |
|---|
Для автоматического выполнения обратной передачи необходимо, чтобы веб-обозреватель поддерживал ECMAScript (JScript или JavaScript), а также чтобы данные сценарии были разрешены в обозревателе пользователя. |
Нет необходимости создавать обработчик событий для события CheckedChanged. Можно протестировать, какие флажки установлены, в любом коде, который выполняется как часть страницы. Как правило, создается обработчик событий для события CheckedChanged, только если необходимо знать, что флажок был изменен, а не просто для чтения значения флажка. Дополнительные сведения см. в разделе Практическое руководство. Установка и получение выбранного элемента в серверном веб-элементе управления RadioButton.
События элемента управления CheckBoxList
Элемент управления CheckBoxList вызывает событие SelectedIndexChanged при выборе любого флажка из списка. По умолчанию это событие не приводит к немедленной отправке страницы на сервер. Однако можно принудительно задать, чтобы элемент управления немедленно выполнил обратную передачу, указав для свойства AutoPostBack значение true.
| Примечание. |
|---|
Для автоматического выполнения обратной передачи необходимо, чтобы обозреватель поддерживал ECMAScript (JScript или JavaScript), а также разрешить эти сценарии в обозревателе пользователя. |
Как и при работе с единичными элементами управления CheckBox, проверка состояния элемента управления CheckBoxList обычно выполняется после отправки страницы каким-либо другим способом. Дополнительные сведения см. в разделе Практическое руководство. Определение выбранного элемента в списочных серверных веб-элементах управления.
Атрибуты HTML-элемента управления CheckBox
При отображении элемента управления CheckBox в обозревателе он обрабатывается как две части: элемент input, соответствующий флажку, и отдельный элемент label, соответствующий подписи к этому флажку. Комбинация двух элементов упаковывается в элемент span.
При применении стиля или параметров атрибутов к элементу управления CheckBox параметры применяются к внешнему элементу. Например, если задать свойство BackColor элемента управления, то параметр применяется к элементу span. Следовательно, оно влияет на оба внутренних атрибута: input и label.
Время от времени может потребоваться применить отдельные параметры для флажка и для метки. Элемент управления CheckBox поддерживает два свойства, которые можно задать во время выполнения. Свойство InputAttributes позволяет добавлять атрибуты HTML к элементу input, а свойство LabelAttributes позволяет добавлять атрибуты HTML к элементу label. Заданные атрибуты передаются в исходном виде в обозреватель. В следующем примере проиллюстрирована процедура задания атрибутов для элемента input таким образом, чтобы при наведении на элемент указателя мыши менял цвет только флажок, а не метка.
[Visual Basic]
CheckBox1.InputAttributes.Add("onmouseover", _
"this.style.backgroundColor = 'red'")
CheckBox1.InputAttributes.Add("onmouseout", _
"this.style.backgroundColor = 'white'")
CheckBox1.InputAttributes.Add("onmouseover",
"this.style.backgroundColor = 'red'");
CheckBox1.InputAttributes.Add("onmouseout",
"this.style.backgroundColor = 'white'");
Привязка данных к элементам управления
Можно выполнить привязку отдельного элемента управления CheckBox к источнику данных, а также можно привязать любое свойство элемента управления CheckBox к любому полю источника данных. Например, обычно свойство Checked элемента управления задается на основе сведений из базы данных.
Кроме того, можно привязать элемент управления CheckBoxList к источнику данных. В этом случае все флажки соответствуют разным записям в источнике данных.
К началу
Примеры кода
Пошаговое руководство. Определение внешнего вида серверного веб-элемента управления CheckBoxList
Практическое руководство. Отклик на выбор пользователя в серверном веб-элементе управления CheckBox
Практическое руководство. Добавление элементов в серверные веб-элементы управления со списком
Практическое руководство. Отклик на изменения в списочных серверных веб-элементах управления
К началу
Справочные сведения по классам
В следующей таблице перечислены классы, связанные с элементами управления CheckBox и CheckBoxList.
Член |
Описание |
|---|---|
Основной класс для элемента управления CheckBox. |
|
Основной класс для элемента управления CheckBoxList. |
|
Класс, представляющий каждый элемент в элементе управления CheckBoxList. |
|
Коллекция элементов, соответствующих отдельным элементам в списке для элемента управления CheckBoxList. |
К началу
См. также
Задачи
Практическое руководство. Выбор элементов в серверных веб-элементах управления "Список"
Ссылки
Общие сведения о серверных веб-элементах управления RadioButton и RadioButtonList