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

В ASP.NET 2.0 введены два новых элемента управления, предназначенных для создания группы сменяющих одна другую панелей дочерних элементов. Элемент управления MultiView определяет группу представлений, создаваемых экземплярами класса View. В каждый конкретный момент времени только одно из них активно и выводится для клиента. Элемент управления View предназначен для использования в составе элемента управления MultiView, а сам по себе он использоваться не может. Вот как определяется элемент управления MultiView:

<asp:MultiView ID="Tables" runat="server">

<asp:View ID="Employees" runat="server">

(здесь какие-то элементы управления)

</asp:View>

<asp:View ID="Products" runat="server">

(здесь другие элементы управления)

</asp:View>

</asp:MultiView>

Выбрать активное представление можно, используя событие возврата формы. Чтобы указать, какое представление будет следующим, можно либо установить свойство ActiveViewIndex, либо передать объект-представление методу SetActiveView().

5.10. Проверочные элементы управления

Кроме визуальных элементов управления, ASP.NET предоставляет набор проверочных элементов. Проверочные элементы управления налагают определенные разработчиком ограничения на данные, вводимые пользователем в формы. При настройке проверочный элемент связывается с элементом управления на форме. В качестве проверяемых могут выступать элементы HTMLInputText, HTMLTextArea, HTMLSelect, HTMLInputFile, TextBox, DropDownList, ListBox, RadioButtonList. В случае если проверка закончилась неудачей, проверочный элемент способен отобразить текстовое разъясняющее сообщение около проверяемого элемента.

В веб-приложении проверка данных, вводимым пользователем, может выполняться на стороне клиента, на стороне сервера или в обоих местах. Проверка на стороне клиента уменьшает количество обменов между клиентом и сервером, необходимых для успешного завершения формы. Однако клиентская проверка может быть выполнена не всегда. Во-первых, для выполнения проверки браузер должен поддерживать язык сценариев. Во-вторых, клиент часто не обладает достаточной информацией, требуемой для завершения проверки. Поэтому проверки на стороне клиента обычно используются в сочетании с проверками на стороне сервера. Достоинство проверочных элементов ASP.NET заключается в том, что они способны автоматически распознавать поддержку клиентом языка сценариев и в зависимости от этого генерировать клиентский либо серверный код проверки.

Рассмотрим общую архитектуру проверочных элементов. Любой проверочный элемент реализует интерфейс System.Web.UI.IValidator, который объявлен следующим образом:

interface IValidator

{

string ErrorMessage { set; get; }

bool IsValid { set; get; }

void Validate();

}

Метод Validate() выполняет процедуру проверки, свойство IsValid указывает, успешно ли выполнилась проверка, а свойство ErrorMessage позволяет определить строку-сообщение в случае провала проверки.

Для всех проверочных элементов базовым является абстрактный класс BaseValidator (из пространства имен System.Web.UI.WebControls), основные элементы которого перечислены в табл. 23.

Таблица 23

Элементы класса BaseValidator

Имя элемента	Описание
ControlToValidate	Строка-идентификатор проверяемого элемента управления
Display	Свойство определяет, должно ли значение проверочного элемента занять некоторое пространство, если оно не выводится. Значение свойства – элемент перечисления ValidatorDisplay
EnableClientScript	Булево свойство, управляет использованием клиентского скрипта для проверки
Enabled	Булево свойство для включения или выключения проверочного элемента
ErrorMessage	Свойство-строка, позволяет установить или прочитать текстовое сообщение, которое отображается в элементе ValidationSummary при неуспешной проверке
ForeColor	Цвет строки проверочного элемента (по умолчанию – красный)
IsValid	Булево свойство, которое показывает, успешно ли выполнилась проверка
SetFocusOnError	Указывает, должен ли элемент управления, который не прошел проверку, получать фокус ввода «
Text	Строка, которую отображает проверочный элемент при провале проверки
ValidationGroup	Имя проверочной группы, к которой принадлежит элемент управления «
Validate()	Метод выполняет процедуру проверку и обновляет значение свойства IsValid

Класс Page хранит список всех проверочных элементов на странице в коллекции Validators. Класс Page также предоставляет метод Validate(), который применяется для коллективного вызова одноимённого метода всех проверочных элементов страницы. Этот метод вызывается на стороне сервера автоматически после загрузки состояния элементов управления страницы. Метод Page.Validate() устанавливает булево свойство страницы IsValid. Как правило, значение данного свойства проверяется в обработчике события Page_Load.

Опишем подробнее конкретные проверочные элементы ASP.NET.

Элемент: RequiredFieldValidator

Назначение: Используется для проверки того, что элемент управления не пуст или значение в нем изменено.

Специфичные свойства:

§ InitialValue – проверка считается не пройденной, если при потере фокуса элементом управления значение в нем равно строке InitialValue. По умолчанию значение свойства – пустая строка.

Элемент: CompareValidator

Назначение: Применяется для сравнения двух полей формы или поля и константы. Может использоваться для того, чтобы проверить, соответствует ли значение поля определенному типу.

Специфичные свойства:

§ ControlToCompare – строка, идентификатор того элемента управления, с которым сравнивается указанный в ControlToValidate элемент.

§ ValueToCompare – значение (в виде строки), с которым сравнивается элемент, связанный с CompareValidator[12].

§ Operator – операция сравнения. Тип свойства – перечисление ValidationCompareOperator, в которое входят следующие элементы: Equal, NotEqual, GreaterThan, GreaterThanEqual, LessThan, LessThanEqual, DataTypeCheck. Если Operator равен DataTypeCheck, то выполняется только проверка того, соответствует ли значение в элементе управления типу, заданному в свойстве Type.

§ Type – тип, в который будет преобразовано значение в элементе управления перед проверкой. Свойство принимает значения из перечисления ValidationDataType c элементами String, Integer, Double, Date, Currency.

Элемент: RangeValidator

Назначение: Проверяет, входит ли значение элемента управления в указанный текстовый или числовой диапазон.

Специфичные свойства:

§ MaximumValue, MinimumValue – строки, задающие диапазон проверки.

§ Type – тип, в который будет преобразовано значение в элементе управления перед проверкой. Аналог соответствующего свойства из CompareValidator.

Элемент: RegularExpressionValidator

Назначение: Проверяет, удовлетворяет ли значение элемента управления заданному регулярному выражению.

Специфичные свойства:

§ ValidationExpression – строка с регулярным выражением.

Элемент: CustomValidator

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

Специфичные свойства и события:

§ OnServerValidate – обработчик этого события должен быть задан для проведения проверки на стороне сервера.

§ ClientValidationFunction – строки с именем клиентской функции, которая будет использоваться для проверки. Так как проверка выполняется на клиенте, то проверочная функция должна быть включена в клиентский скрипт и может быть написана на JavaScript или на VBScript.

Элемент: ValidationSummary

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

Специфичные свойства:

§ DisplayMode – свойство позволяет выбрать вид суммарного отчета об ошибках. Значения свойства – элемент перечисления ValidationSummaryDisplayMode: BulletList (по умолчанию), List, SingleParagraph.

§ HeaderText – строка с заголовком отчета.

§ ShowMessageBox – если это булево свойство установлено в true, то отчет отображается в отдельном диалоговом окне.

§ ShowSummary – если свойство установлено в true (по умолчанию), то отчет отображается на странице. Это свойство часто используется совместно с ShowMessageBox.

Дата добавления: 2014-01-11