Validate Função

Aplica-se a: Aplicativos de tela controlados por modelos

A Validate função verifica se o valor de uma única coluna ou um registro completo é válido para uma fonte de dados.

Descrição

Antes que um usuário envie uma alteração de dados, você pode fornecer um feedback imediato sobre a validade desse envio, resultando em uma melhor experiência para o usuário.

Fontes de dados podem fornecer informações sobre o que constitui valores válidos dentro de um registro. Essas informações podem incluir muitas restrições, conforme os exemplos a seguir:

• se uma coluna requer um valor
• o comprimento máximo de uma cadeia de caracteres
• limites mínimo e máximo de um número
• limites mínimo e máximo de uma data

A Validate função usa essas informações para determinar se um valor é válido e para retornar uma mensagem de erro apropriada, caso contrário. Você pode usar a função DataSourceInfo para exibir as mesmas informações que Validate usa.

As fontes de dados variam em quantas informações de validação elas fornecem, incluindo não fornecer nenhuma. Validate só pode verificar valores com base nessas informações. Mesmo que Validate não encontre um problema, a aplicação da alteração de dados ainda poderá falhar. Você pode usar a função Errors para obter informações sobre a falha.

Se Validate encontrar um problema, a função retornará uma mensagem de erro que você pode mostrar ao usuário do aplicativo. Se todos os valores forem válidos, Validate retornará em branco. Quando você trabalha com um coleção que não possui nenhuma informação de validação, os valores são sempre válidos.

Sintaxe

Validate( DataSource, Column, Value )

• DataSource – Obrigatório. A fonte de dados usada para a validação.
• Coluna – Obrigatório. A coluna a ser validada.
• Value – obrigatório. O valor para a coluna selecionada a ser validado.

Validate( DataSource, OriginalRecord, Updates )

• DataSource – Obrigatório. A fonte de dados usada para a validação.
• OriginalRecord - Obrigatório. O registro para o qual as atualizações devem ser validadas.
• Atualizações - Obrigatórias. As alterações a serem aplicadas ao registro original.

Exemplos

Para esses exemplos, os valores na coluna porcentagem da fonte de dados de Pontuações deve estar entre 0 e 100, inclusive. Se os dados passam na validação, a função retorna em branco. Caso contrário, a função retornará uma mensagem de erro.

Validate com uma única coluna

Validate com um registro completo