ASP.NET CustomValidatorЭлемент управления


Validation Server ControlsСерверный элемент управления проверки

Определение и использование

Элемент управления CustomValidator позволяет создавать методы для обработки проверки входных значений.


Свойства

Свойства Описание
BackColor Цвет фона элемента управления CustomValidator.
ClientValidationFunction Указывает имя клиентской функции сценария, которая должна быть выполнена.Примечание:Сценарий должен быть написан на языке, поддерживаемом браузером, например VBScript или JScript.

При использовании VBScript функция должна быть размещена внутри формы:

Sub FunctionName (source, arguments)

При использовании JScript функция должна быть размещена внутри формы:

Function FunctionName (source, arguments)

ControlToValidate Идентификатор проверяемого элемента управления.
Отобразить Поведение отображения элемента управления проверки. Допустимые значения:
  • None — элемент управления не отображается. Он используется только для отображения сообщений об ошибках в элементе управления ValidationSummary.
  • Статический — если проверка не проходит, элемент управления отображает сообщение об ошибке. Даже если ввод проходит проверку, на странице резервируется место для отображения сообщения, т. е. пространство, используемое для сообщения, предварительно выделяется.
  • Динамический — если проверка не проходит, элемент управления отображает сообщение об ошибке. Если ввод проходит проверку, на странице не резервируется место для сообщения, т. е. пространство, используемое для сообщения, добавляется динамически.
EnableClientScript Логическое значение, указывающее, включена ли проверка на стороне клиента.
Enabled Логическое значение, указывающее, включен ли элемент управления проверки.
ErrorMessage Текст, отображаемый в элементе управления ValidationSummary при неудачной проверке.Примечание:Если свойство Text не задано, текст также будет отображаться в элементе управления проверки.
ForeColor Цвет переднего плана элемента управления.
id Уникальный идентификатор элемента управления.
IsValid Логическое значение, указывающее, проходит ли проверку элемент управления, указанный в ControlToValidate.
OnServerValidate Указывает имя серверной функции сценария проверки, которая должна быть выполнена.
runat Указывает, что элемент управления является серверным элементом управления. Должно быть установлено значение "server".
Текст Сообщение, отображаемое при неудачной проверке.


Пример

CustomValidator
В этом примере мы объявляем два элемента управления Label, элемент управления TextBox, элемент управления Button и элемент управления CustomValidator в файле .aspx. Функция user() может определить длину входного значения. Если длина меньше 8 или больше 16, в элементе управления CustomValidator отображается текст "Имя пользователя должно содержать от 8 до 16 символов!".


Validation Server ControlsСерверный элемент управления проверки Другие расширения