Função Validate

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

A função Validate 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 função Validate usa essas informações para determinar se um valor é válido e retornar uma mensagem de erro apropriada se o valor não for válido. Você pode usar a função DataSourceInfo para exibir as mesmas informações que a função Validate.

As fontes de dados variam em quantas informações de validação elas fornecem, incluindo não fornecer nenhuma. A função Validate só pode verificar valores com base nessas informações. Mesmo se Validate não encontrar 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 a função 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, a função Validate retorna blank. 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.
• Column - 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.
• Updates - obrigatório. 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.

Validar com uma única coluna

Validar com um registro completo