Таблица 37.1. Стандартные Web-серверные элементы управления

Элемент управления

Label

TextBox

Button

LinkButton ImageButton

HyperLink

DropDownList

ListBox

CheckBox

CheckBoxList

Описание

Простое отображение текста; для установки и программной модификации отображаемого текста необходимо использовать свойство Text.

Представляет текстовое поле, текст в котором можно редактировать. Для доступа к введенным данным следует использовать свойство Text, а событие TextChanged - для обработки изменений. Если необходима автоматическая обратная отправка (как альтернатива применению кнопки), установите свойство AutoPostBack равным true.

Стандартная кнопка, на которой пользователь может щелкать. Свойство Text представляет текст на кнопке, а событие Click - реакцию на щелчки (обратная отправка на сервер выполняется автоматически). Можно также использовать событие Command для ответа на щелчки, что дает доступ к дополнительным свойствам CommandName и CommandArgument при приеме.

Аналогично Button, но отображает кнопку как гиперссылку.

Выводит графическое изображение, ведущее себя подобно кнопке, на котором можно щелкать. Свойства и события унаследованы от Button и Image.

Гиперссылка HTML. Адрес назначения устанавливается свойством NavigateUrl, а отображаемый текст - Text. Можно также использовать ImageUrl для указания графического изображения ссылки и Target - для указания целевого окна браузера. Этот элемент управления не имеет нестандартных событий, поэтому если нужна дополнительная обработка при переходе по ссылке, следует применять LinkButton.

Выпадающий список; дает возможность пользователю выбирать один элемент из списка возможных либо указанием его в списке, либо вводом первой буквы. Для установки списка элементов служит свойство Items

(класс ListItemCollection, содержащий элементы типа ListItem), а свойства SelectedItem и SelectedIndex применяются для определения выбранного элемента. Событие SelectedIndexChanged может использоваться для определения того, что выбор изменился. Кроме того, доступно свойство AutoPostBack, указывающее на необходимость выполнения действия обратной отправки при смене выбора.

Окно списка; дает возможность пользователю выбирать одну или более позиций списка. Для указания того, может ли быть выбрана только одна позиция или много, свойству SelectionMode присваивается значение, соответственно, Multiple или Single. Свойство Rows задает количество отображаемых элементов (строк). Все прочие свойства и события - как у DropDownList.

Отображает окошко, которое может быть помечено (флажок). Состояние сохраняется в свойстве булевского типа с именем Checked, а ассоциированный с ним текст - в свойстве Text. Свойство AutoPostBack может использоваться для инициирования автоматической обратной отправки, а событие CheckedChanged - для обработки изменений.

Группа флажков. Свойства и события идентичны другим списочным элементам управления, таким как DropDownList.

Продолжение табл. 37.1

Элемент управления

RadioButton

RadioButton List

Image

ImageMap

Table

BulletedList

HiddenField

Literal

Calendar

Описание

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

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

Выводит графическое изображение. Для ссылки на изображение используется ImageUrl, а AlternateText - для вывода текста при невозможности загрузки изображения.

Подобно Image, но позволяет специфицировать определенные действия, которые нужно инициировать, когда пользователь щелкает на определенных горячих областях изображения. Эти действия могут быть связаны либо с обратной отправкой, либо с переадресацией по другому URL-адресу. Горячие области определяются встроенными элементами управления, унаследованными от HotSpot - такими как RectangleHotSpot и CircleHotSpot.

Специфицирует таблицу. Используется в сочетании TableRow и TableCell на этапе проектирования либо позволяет программно присваивать строки через свойство Rows типа TableRowCollection. Это свойство также можно применять для модификаций во время выполнения. Этот элемент управления имеет некоторые стилистические свойства, уникальные для таблиц, вроде TableRow и TableCell.

Форматирует список с метками. В отличие от других списочных элементов управления имеет событие Click, которое можно применять при обратной отправке для определения того, на каком элементе списка щелкнул пользователь. Прочие свойства и события - как у DropDownList.

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

Выполняет ту же функцию, что и Label, но не имеет свойств, задающих стиль, а только Text (поскольку унаследован от Control, а не от WebControl). Отображаемый текст задается с помощью свойства Text.

Позволяет выбирать дату из графического календаря. Этот элемент управления имеет множество свойств, связанных со стилем, но основная функциональность обеспечивается свойствами SelectedDate и VisibleDate (типа System.DateTime), предоставляющим доступ к дате, выбранной пользователем, и отображаемому месяцу (который всегда содержит VisibleDate). Ключевое событие - SelectionChanged. Обратная отправка - автоматическая.

Окончание табл. 37.1

Элемент управления

AdRotator

FileUpload

Wizard

MultiView

Panel

PlaceHolder

View

Substitution

Localize

Описание

Отображает несколько графических изображений последовательно, причем каждое следующее отображается после обращения к серверу. Свойство AdvertisementFile позволяет указать XML-файл, описывающий возможные изображения, а событие AdCreated выполняет обработку перед тем, как каждое изображение отправляется обратно. Можно также использовать свойство Target для именования окна, открываемого после щелчка.

Этот элемент управления предоставляет пользователю текстовое поле с кнопкой Browse (Обзор), позволяющей выбрать загружаемый файл. После того, как пользователь это сделает, можно обратиться к свойству HasFile, чтобы убедиться, что файл выбран, а затем применить метод SaveAs() для выполнения загрузки файла на сервер.

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

Наиболее сложный элемент управления для отображения текста. Используется для показа содержимого XML, которое может быть трансформировано с применением таблицы стилей XSLT. Содержимое XML устанавливается с использованием одного из свойств - Document, DocumentContent или DocumentSource (в зависимости от формата исходного XML) и таблицы стилей XSLT (не обязательно), используя либо

Transform, либо TransformSource.

Элемент управления, содержащий в себе один или более элементов View, причем в конкретный момент времени отображается только один View. Текущий активный элемент View указывается с помощью ActiveViewIndex, и можно определить, изменялся ли он (возможно, через ссылку Next) с помощью события ActiveViewChanged.

Контейнер для других элементов управления. Для указания размещения элементов можно использовать свойства HorizontalAlign и Wrap.

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

Контейнер для элементов управления, подобный PlaceHolder, но включенный в MultiView. Можно указать его видимость через атрибут Visible, а также использовать события Activate и Deactivate для обнаружения изменений в состоянии активности.

Специфицирует раздел Web-страницы, который не кэшируется вместе с остальным выводом. Это усовершенствованное средство, связанное с поведением кэширования ASP.NET, которое в настоящей книге нам не понадобится.

Выполняет ту же функцию, что и Literal, но разрешает локализовать текст с помощью ресурсов проекта, позволяющих задать текст для отображения в разных местах.