Controle CustomValidator do ASP.NET

Controle de Servidor de Validação

Definição e uso

O controle CustomValidator pode executar validações personalizadas para controles de entrada.

Propriedade

Propriedade Descrição
BackColor Cor de fundo do controle CustomValidator.
ClientValidationFunction

Nome da função de script de validação do cliente personalizado.

Notas: O script deve ser escrito em um linguagem suportada pelo navegador, como VBScript ou JScript

Se estiver usando VBScript, a função deve estar localizada dentro do formulário:

Sub FunctionName (source, arguments)

Se estiver usando JScript, a função deve estar localizada dentro do formulário:

Function FunctionName (source, arguments)
ControlToValidate ID do controle de entrada a ser validado.
Display

Comportamento de exibição da mensagem de erro no controle de validação.

Os valores válidos são:

  • Nenhum - A mensagem de validação nunca é exibida inline.
  • Estático - O espaço para exibir a mensagem de validação é alocado no layout da página.
  • Dinâmico - Se a verificação falhar, o espaço para exibir a mensagem de validação será adicionado dinamicamente à página.
EnableClientScript Valor booleano, indica se a validação do cliente está habilitada.
Enabled Valor booleano, indica se o controle de validação está habilitado.
ErrorMessage

Texto da mensagem de erro exibida no controle ValidationSummary quando a validação falhar.

Notas: Se o ErrorMessage for configurado mas o Text não, o valor do ErrorMessage também será exibido no controle de validação.
ForeColor Cor de primeiro plano do controle.
id ID exclusivo do controle.
IsValid Valor booleano, indica se o controle de entrada associado passou na verificação.
OnServerValidate Define o nome da função de validação do servidor que será executada.
runat Define que o controle é um controle de servidor. Deve ser configurado como "server".
Texto Texto exibido quando a verificação falha.

Exemplo

CustomValidator
Neste exemplo, declaramos dois controles Label, um controle TextBox, um controle Button e um controle CustomValidator no arquivo .aspx. A função user() pode detectar o comprimento da entrada. Se o comprimento for menor que 8 ou maior que 16, o texto "O nome de usuário deve estar entre 8 e 16 caracteres!" será exibido no controle CustomValidator.

Controle de Servidor de Validação