Вход/Регистрация
C# для профессионалов. Том II
вернуться

Ватсон Карли

Шрифт:
Элементы управления проверкой достоверности

Элементы управления проверкой достоверности предоставляют метод проверки достоверности ввода пользователя (в большинстве случаев) вообще без написания какого-либо кода. Когда инициируется обратная отправка, каждый элемент управления выполняет проверку, которую он подтверждает, и изменяет соответственно свое свойство

isValid
. Если это свойство будет
false
, то ввод пользователя для элемента проверки достоверности не получил подтверждение. Страница, содержащая все элементы управления, также имеет свойство
isValid
: если у какого-либо из элементов управления проверкой достоверности свойство
isValid
задано как
false
, то это свойство страницы также будет иметь значение
false
. Это свойство можно проверять из серверного кода и действовать в соответствии с ним.

Однако элементы управления проверкой достоверности имеют вторую функцию. Они не только проверяют элементы управления во время выполнения, но могут также автоматически выводить пользователям полезные рекомендации. Если задать для свойства

ErrorMessage
какое угодно текстовое значение, то пользователь увидит его, когда попытается отправить назад неверные данные.

Хранящийся в

ErrorMessage
текст можно вывести в том месте, где расположен элемент управления проверкой достоверности или в другом месте с сообщениями обо всех других элементах управления проверкой достоверности на странице. Такое поведение достигается с помощью элемента управления
ValidationSummary
, который выводит, если потребуется, все сообщения об ошибках вместе с дополнительным текстом.

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

Все элементы управления проверкой наследуют из класса

BaseValidator
, и поэтому обладают некоторыми общими важными свойствами. Возможно, наиболее важным является рассмотренное выше свойство
ErrorMessage
и в этом случае свойство
ControlToValidate
можно считать вторым по важности. Это свойство определяет идентификатор (ID) элемента управления, который проверяется. Другим важным свойством является
Display
, которое определяет, поместить ли текстовое сообщение в итоговой позиции проверки (если задано как none) или в позиции проверяющего элемента. Имеется также возможность оставить место для сообщения об ошибке, даже когда оно не выводится (задавая
Display
как
Static
) или динамически выделять место, когда потребуется, что может слегка сдвигать содержимое страницы (задавая
Display
как
Dynamic
).

Мы скоро рассмотрим пример, но сначала кратко опишем различные элементы управления проверкой:

Элемент управления Описание
RequiredFieldValidator
Используется для проверки, ввел ли пользователь данные в элемент управления, такой как
TextBox
.
CompareValidator
Используется для проверки того, что введенные данные удовлетворяют простым требованиям, происходит сравнение с оператором
set
, использующим свойство
Operator
и свойство
ValueToCompare
.
Operator
может быть одним из
Equal
,
GreaterThan
,
GraterThenEqual
,
LessThen
,
LessThenEqual
,
NotEqual
или
DataTypeCheck
. Последний из них просто сравнивает тип данных ValueToCompare с данными в проверяемом элементе управления (
ValueToCompare
является строковым свойством, но интерпретируется как другой тип данных на основе своего содержимого).
RangeValidator
Проверяет, что данные в элементе управления для проверки находятся между значениями свойств
MaximumValue
и
MinimumValue
.
RegularExpressionValidator
Проверяет содержимое поля на основе регулярного выражения, хранящегося в
ValidationExpression
. Это может быть полезно для известной последовательности, такой как zip-коды, телефонные номера, IP-номера и т.д.
CustomValidator
Применяется для проверки данных в элементе управления с помощью специальной функции.
ClientValidationFunction
используется для определения клиентской функции, используемой для проверки элемента управления (это означает, к сожалению, что мы не можем использовать C#). Эта функция должна возвращать логическое значение, указывающее, была проверка успешной или нет. Альтернативно можно взять событие
ServerValidate
для определения серверной функции, используемой для проверки. Эта функция является обработчиком событий с булевым типом, которая получает строку, содержащую данные для проверки вместо параметра
EventArgs
. Мы возвращаем
true
, если проверка проходит успешно, иначе
false
.

Пример серверного элемента управления

Теперь мы разберем простой пример — пришло время взглянуть на более сложный сценарий. Давайте создадим каркас приложения Web — утилиту для заказа помещения для собраний. В данный момент он будет содержать только внешний интерфейс и простую обработку событий, позже мы расширим его с помощью ADO.NET и связывания данных, чтобы включить серверную бизнес-логику.

Форма Web, которую мы собираемся создать, будет содержать поля для имени пользователя, имени события, помещения для собраний и служителей вместе с календарем для выбора даты (предполагается в этом примере, что события продолжаются в течение полного дня). Используем элементы управления проверкой для всех полей, за исключением календаря, который будет проверяться на сервере и предоставлять дату по умолчанию в случае, если ничего не было введено.

Для тестирования интерфейса пользователя мы будем также иметь на форме элемент управления

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

Вначале создадим в Visual Studio новый проект приложения Web с именем

PCSWebApp2
. Затем мы создаем форму, которая генерируется с помощью следующего кода в
WebForm1.aspx
(код, генерируемый автоматически, не выделен):

<%@ Page language="c#" Codebehind="WebForm1.aspx.cs" AutoEventWireup="false" Inherits="PCSWebApp2.WebForm1" %>

<html>

 <head>

<meta content=False name=vs_showGrid>

<meta content="Internet Explorer 5.0" name="vs_targetSchema>

<meta content="Microsoft Visual Studio 7.0" name=GENERATOR>

<meta content=C# name=CODE_LANGUAGE>

 </head>

 <body>

<form method="post" runat="server">

<h1 align="center">Enter details and set a day to initiate an event.</h1>

<br>

<table borderColor="#000000" cellSpacing="0" cellPadding="8"

rules="none" align="center" bgColor="#fff99e" border="2" width="540">

<tr>

<td vAlign="top">Your Name:</td>

<td vAlign="top">

<asp:textbox id="nameBox" runat="server" width="160px" />

  • Читать дальше
  • 1
  • ...
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • ...

Ебукер (ebooker) – онлайн-библиотека на русском языке. Книги доступны онлайн, без утомительной регистрации. Огромный выбор и удобный дизайн, позволяющий читать без проблем. Добавляйте сайт в закладки! Все произведения загружаются пользователями: если считаете, что ваши авторские права нарушены – используйте форму обратной связи.

Полезные ссылки

  • Моя полка

Контакты

  • chitat.ebooker@gmail.com

Подпишитесь на рассылку: