AutoPostBack. Привязка к данным. Коллекции. Проверка правильности вводимых данных

Классы проверки данных (валидаторы)

Данные из форм обычно записываются в базы данных, и тип информации в них должен соответствовать типу и длине данных в полях таблиц баз данных. Кроме того, иногда нужно вводить взаимосвязанные данные, например, пароль во время регистрации нужно вводить 2 раза и он в обоих полях должен совпадать. Некоторые хакеры пытаются вводить в формы программные коды, чтобы взломать вашу систему. Бдительность и еще раз бдительность, как говорил товарищ... не помню кто. А если пользователь ввел неверные данные случайно, сервер выдаст непонятное сообщение об ошибке, и ценный клиент уйдет с нашего сайта на другой.

Прежде чем работать с данными, нужно убедиться, что:

Проверка может происходить и на стороне клиента, и на сервере. При валидации на стороне клиента в страницу встраивается код на Javascript. Если данные в форме не проходят проверку, страница просто не будет отправлена на сервер. Таким образом мы избежим лишнего трафика и не будем загружать сервер. С другой стороны, валидация на стороне сервера более надежна. Javascript-код хакеры могут легко посмотреть и отправить неправильные данные, которые пройдут эту проверку. Наконец, Javascript можно просто выключить в настройках браузера. При валидации на стороне сервера данные проверяются программой на полноценном языке. Ее код пользователю неизвестен. В результате проверки генерируется новая страница с сообщениями об ошибках. Самая разумная стратегия — применять комбинацию этих методов. Предварительная проверка у клиента защитит от опечаток, а серьезная проверка на сервере — от злонамеренного взлома.

Существует целый ряд серверных элементов управления, которые не занимаются выводом информации, а проверяют данные, введенные пользователем. ASP .NET 2.0 сам определяет тип браузера и генерирует наиболее подходящий для данного случая код. Если браузер поддерживает Javascript-код, который он может послать, то валидация или ее часть происходит на стороне клиента. Если браузер не поддерживает Javascript, то вся валидация происходит на сервере.

Получить доступ к валидаторам просто — раскройте в Toolbox вкладку "Validation".

Классы валидаторов образуют иерархию, во главе которой стоит абстрактный класс BaseValidator.

Базовый класс валидаторов сам наследник класса Label, так что по существу все валидаторы — метки, текст в которых становится видимым, когда не выполняются заданные нами условия проверки. По умолчанию текст в валидаторах — красный (вспомните школу и замечания учительницы в тетради). Но, конечно же, этот цвет можно поменять на более приятный. Все валидаторы имеют свойство ControlToValidate. Оно задает тот элемент управления, данные в котором проверяются данным валидатором. Этот элемент должен находиться в одном контейнере с валидатором.

Инициация проверки данных

Проверка всегда инициируется каким-либо событием. Обычно это щелчок на кнопках Button, ImageButton, LinkButton, в которые по умолчанию свойство CausesValidation установлено в True. Можно убрать это свойство для некоторых кнопок, которым оно не нужно, например, для кнопки Cancel.

В примере с автосалоном на странице имеются несколько валидаторов:

<asp:requiredfieldvalidator id="RequiredFieldValidator2" 
runat="server" 
	ErrorMessage="Required" 
	ControlToValidate="DropDownList1">
		</asp:requiredfieldvalidator>

Класс RequiredFieldValidator проверяет, было ли изменено значение в связанном с ним элементе управления. Если, как в данном случае, это выпадающий список — первоначально выбрано пустое значение, но требуется, чтобы пользователь выбрал конкретную марку. Если выбор не был сделан, но кнопка submit была нажата, валидация проваливается и выводится текст, заданный в ErrorMessage или в Text. Валидаторы отображают текст, указанный в свойстве "Text", всегда, когда оно не пусто, а текст, установленный в свойстве "ErrorMessage" — тогда, когда свойство "Text" равно "". Первоначальное значение задается свойством InitialValue. Если это свойство не задано, то проверка проводится на отсутствие значения (например, пустой Textbox ).

Для проверки корректности ввода электронного адреса используется класс RegularExpressionValidator:

<span class="label">Your Email</span><span 
class="label1">(Required)</span>
	<asp:textbox id="TextBox1" runat="server"></asp:textbox>
	<asp:RegularExpressionValidator 
id="RegularExpressionValidator1" runat="server" 
ControlToValidate="TextBox1" ErrorMessage="Not a valid Email" 
ValidationExpression="\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-
.]\w+)*"></asp:RegularExpressionValidator>
	<asp:RequiredFieldValidator id="RequiredFieldValidator1" 
runat="server" ControlToValidate="TextBox1" 
ErrorMessage="*"></asp:RequiredFieldValidator>
</span>

ValidationExpression — регулярное выражение, на соответствие которому проходит проверку значение текстового поля. В Visual Studio 2005 предоставляет несколько готовых шаблонов регулярных выражений, которые можно выбрать в окне свойств, — телефонных номеров разных стран, адресов, и, самое полезное, шаблоны электронной почты и адреса в Интернете.

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

Свойство Page.IsValid позволяет определить, прошла ли вся страница валидацию. Для браузеров, которые поддерживают DHTML, проверка происходит на стороне клиента. Для этого автоматически генерируется JavaScript-код. Таким образом экономятся ресурсы сервера и трафик, которые бы пришлось потратить на передачу неправильных данных.

Валидаторы сравнения

CompareValidator сравнивает значение со значением в другом элементе управления или с константой. Также можно проверить, можно ли конвертировать значение в связанном с ним элементе управления в какой-либо тип.

Свойство Operator позволяет установить операцию, посредством которой происходит сравнение: Equal, NotEqual, GreaterThan, GreaterThanEqual, LessThan, LessThanEqual. Значение DataTypeCheck означает проверку на соответствие типу.

Свойство Type может принимать значения String, Integer, Date, Double и Currency.

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

RangeValidator проверяет соответствие введенного значения диапазону, заданному свойствами MinimumValue и MaximumValue:

<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<asp:RangeValidator ID="RangeValidator1" runat="server" 
    ControlToValidate="TextBox1"
    ErrorMessage="Не больше 10 бутылок пива в одни руки" 
    MaximumValue="10" MinimumValue="1" Type="Integer">
</asp:RangeValidator>

ValidationSummary

Класс ValidationSummary позволяет вывести итоговую информацию по всем валидаторам на странице. Она может быть выведена в различной форме:

Информацию можно выводить на странице, а можно в информационном окне, если ShowMessage поставить в True. Для всех валидаторов выводится свойство Error Message, а не текст. Text выводится в самом валидаторе.

Вернемся к странице Registration.aspx. Добавим в него еще одно поле для ввода пароля:

<form runat="server" id="input">
    <asp:Label ID="Label1" runat="server" Text="Введите имя:" 
Width="140px"></asp:Label>
<asp:TextBox ID="txtName" runat="server" CausesValidation="True" 
/>
    <asp:Label ID="Label2" runat="server" Text="Введите адрес:" 
Width="140px"></asp:Label>
<asp:TextBox id="txtAddress" runat="server" textmode="multiline" 
rows="5"
/>
<br/><br />
    <asp:Label ID="Label3" runat="server" Text="Введите пароль:" 
Width="140px"></asp:Label>
    <asp:TextBox id="txtPassword" runat="server" textmode="password" />
    <br />
<br />
    <asp:Label ID="Label4" runat="server" Text="Повторите пароль" 
Width="140px"></asp:Label>
    <asp:TextBox id="TextBox1" runat="server" textmode="password" 
/><br />
   <asp:Button ID="Button1" runat="server" Text="Submit" />
</form>

Свойство CausesValidation работает, когда элемент управления теряет фокус. В таком случае связанный с ним валидатор показывает значение своего свойства Text.

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

Перетащите RequiredFieldValidator и бросьте его на форму. ControlToValidate установите в txtName. Второй валидатор — Required FieldValidator для пароля. Третий — CompareValidator, который сравнивает значение паролей:

<asp:RequiredFieldValidator ID="RequiredFieldValidator1" 
ControlToValidate="txtName"
    Display="Static" ErrorMessage="Имя необходимо ввести" 
runat="server" >*</asp:RequiredFieldValidator>

        <asp:RequiredFieldValidator ID="RequiredFieldValidator2" 
runat="server" ErrorMessage="Пароль не должен быть пустым" 
ControlToValidate="txtPassword1">*</asp:RequiredFieldValidator>

<asp:CompareValidator ID="CompareValidator1" runat="server"
    ControlToValidate="txtPassword1"
    ErrorMessage="Пароли должны совпадать!" 
ControlToCompare="txtPassword2"></asp:CompareValidator><br />

А также один ValidationSummary:

<asp:ValidationSummary ID="ValidationSummary1" runat="server" />

Поставим кнопку, при нажатии на которую будет происходить проверка:

<asp:Button ID="Button1" runat="server" Text="Валидация" 
OnClick="Validate_Click" />

Обработчик нажатия на кнопку подтверждает ввод, если валидация прошла успешно:

protected void Validate_Click(object sender, EventArgs e)
    {
        if (Page.IsValid)
        {
            lblName.Text = "";
            lblAddress.Text = "";
            lblPassword.Text = "";
            input.Visible = false;
            if (txtName.Text != "")
                lblName.Text = "Вы ввели имя: " + txtName.Text;
            if (txtAddress.Text != "")
                lblAddress.Text = "Вы ввели адрес: " +
            txtAddress.Text;
            if (txtPassword1.Text != "")
              lblPassword.Text = "Вы ввели пароль: " +
                 txtPassword1.Text + "<br>Спасибо за регистрацию!";
        }
    }

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

CustomValidator

Если нужно сделать такую проверку, которую не получается осуществить с помощью стандартных валидаторов, в игру вступает Custom Validator. В классе CustomValidator можно написать любую функцию, которая будет проверять значения как на стороне сервера, так и у клиента. Классический пример — проверка числа на четность.

Напишем пользовательский валидатор, который будет проверять пароль на длину — не меньше 5 символов:

<head>
    <title>Регистрация нового пользователя</title>
<script language="JavaScript">
function validatePassword(oSrc, args)
{
    args.IsValid = (args.Value.length > 5); 
}
</script>

</head>
    <asp:CustomValidator ID="CustomValidator1" runat="server" 
        ControlToValidate="txtPassword1"
        ErrorMessage="Слишком короткий пароль" Display="Static"
        ClientValidationFunction="validatePassword" 
>*</asp:CustomValidator>

Проверка происходит на стороне клиента функцией на JavaScript validatePassword. Для этого надо в свойстве ClientValidationFunction записать имя функции. В сгенерированном коде к кнопке привязан такой код:

<input type="submit" name="Button1" value="Button" 
onclick="javascript:WebForm_DoPostBackWithOptions(new 
WebForm_PostBackOptions("Button1", "true", "false", "false"))" 
id="Button1" />

Известно, что если функция, связанная с onclick, вернет логическое значение false, форма не будет отправлена на сервер:

<asp:CustomValidator ID="CustomValidator1" runat="server" 
        ControlToValidate="txtPassword1"
        ErrorMessage="Слишком короткий пароль" Display="Static"
        OnServerValidate="ServerValidate" 
>*</asp:CustomValidator><br />

Произведем такую же валидацию на сервере. Чтобы запустить проверку на сервере, используется свойство OnServerValidate. Функция, которая указана в ней, входит в класс страницы и должна быть написана на C#:

void ServerValidate(object source, ServerValidateEventArgs args)
    {
        string password = args.Value.ToString();
        int len = password.Length;
        args.IsValid = (len >= 5);
    }

ServerValidate вызывается после события Page_Load, поэтому нельзя, как в лекции 3, выводить результаты в Page_Load.

Можно также одновременно проводить и клиентскую, и серверную валидацию:

<asp:CustomValidator ID="CustomValidator1" runat="server" 
        ControlToValidate="txtPassword1"
        ErrorMessage="Слишком короткий пароль" Display="Static"
        OnServerValidate="ServerValidate" 
        ClientValidationFunction="validatePassword" 
>*</asp:CustomValidator>

Чтобы отключить возможность генерации клиентского кода для всех валидаторов, можно написать

void Page_Load()
    {
        foreach (BaseValidator bv in Page.Validators)
        {
            bv.EnableClientScript = false;
        }
    }

Для отображения сообщения об ошибке можно использовать звуки и картинки. Для этого в свойство ErrorMessage нужно записать не текст, а соответствующие теги HTML, например

ErrorMessage=’<img src="error.gif">’

Группы валидации

Иногда бывает нужно иметь на странице несколько кнопок, и при нажатии на каждую вводится информация из логически взаимосвязанных групп элементов управления. Поэтому должны проверяться значения только из этой группы. У всех валидаторов и элементов управления, через которые возможен ввод информации, есть свойство ValidationGroup. Функцию Page.Validate() тоже можно использовать с таким параметром. Если происходит нажатие на кнопку с установленным ValidationGroup, запускается проверка тех валидаторов, у которых это свойство такое же.

Заключение

Назначение форм — в том, чтобы получать данные от пользователей, но данные не имеют смысла, если они введены неправильно. Элементы- валидаторы позволяют автоматизировать рутинные действия по проверке данных и гарантировать ввод данных, соответствующих нашим требованиям.